dodopayments 2.1.2 → 2.3.0

data/lib/dodopayments/models/product_collection_list_params.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#list
+    class ProductCollectionListParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute archived
+      #   List archived collections
+      #
+      #   @return [Boolean, nil]
+      optional :archived, Dodopayments::Internal::Type::Boolean
+
+      # @!attribute brand_id
+      #   Filter by Brand id
+      #
+      #   @return [String, nil]
+      optional :brand_id, String
+
+      # @!attribute page_number
+      #   Page number default is 0
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer
+
+      # @!attribute page_size
+      #   Page size default is 10 max is 100
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!method initialize(archived: nil, brand_id: nil, page_number: nil, page_size: nil, request_options: {})
+      #   @param archived [Boolean] List archived collections
+      #
+      #   @param brand_id [String] Filter by Brand id
+      #
+      #   @param page_number [Integer] Page number default is 0
+      #
+      #   @param page_size [Integer] Page size default is 10 max is 100
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_list_response.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#list
+    class ProductCollectionListResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute id
+      #   Collection ID
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #   Timestamp when created
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute name
+      #   Collection name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute products_count
+      #   Number of products in the collection
+      #
+      #   @return [Integer]
+      required :products_count, Integer
+
+      # @!attribute updated_at
+      #   Timestamp when last updated
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #   Collection description
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute image
+      #   Collection image URL
+      #
+      #   @return [String, nil]
+      optional :image, String, nil?: true
+
+      # @!method initialize(id:, created_at:, name:, products_count:, updated_at:, description: nil, image: nil)
+      #   @param id [String] Collection ID
+      #
+      #   @param created_at [Time] Timestamp when created
+      #
+      #   @param name [String] Collection name
+      #
+      #   @param products_count [Integer] Number of products in the collection
+      #
+      #   @param updated_at [Time] Timestamp when last updated
+      #
+      #   @param description [String, nil] Collection description
+      #
+      #   @param image [String, nil] Collection image URL
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#retrieve
+    class ProductCollectionRetrieveParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_retrieve_response.rb

@@ -0,0 +1,226 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#retrieve
+    class ProductCollectionRetrieveResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the product collection
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute brand_id
+      #   Brand ID for the collection
+      #
+      #   @return [String]
+      required :brand_id, String
+
+      # @!attribute created_at
+      #   Timestamp when the collection was created
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute groups
+      #   Groups in this collection
+      #
+      #   @return [Array<Dodopayments::Models::ProductCollectionRetrieveResponse::Group>]
+      required :groups,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::ProductCollectionRetrieveResponse::Group] }
+
+      # @!attribute name
+      #   Name of the collection
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute updated_at
+      #   Timestamp when the collection was last updated
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #   Description of the collection
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute image
+      #   URL of the collection image
+      #
+      #   @return [String, nil]
+      optional :image, String, nil?: true
+
+      # @!method initialize(id:, brand_id:, created_at:, groups:, name:, updated_at:, description: nil, image: nil)
+      #   @param id [String] Unique identifier for the product collection
+      #
+      #   @param brand_id [String] Brand ID for the collection
+      #
+      #   @param created_at [Time] Timestamp when the collection was created
+      #
+      #   @param groups [Array<Dodopayments::Models::ProductCollectionRetrieveResponse::Group>] Groups in this collection
+      #
+      #   @param name [String] Name of the collection
+      #
+      #   @param updated_at [Time] Timestamp when the collection was last updated
+      #
+      #   @param description [String, nil] Description of the collection
+      #
+      #   @param image [String, nil] URL of the collection image
+
+      class Group < Dodopayments::Internal::Type::BaseModel
+        # @!attribute group_id
+        #
+        #   @return [String]
+        required :group_id, String
+
+        # @!attribute products
+        #
+        #   @return [Array<Dodopayments::Models::ProductCollectionRetrieveResponse::Group::Product>]
+        required :products,
+                 -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::ProductCollectionRetrieveResponse::Group::Product] }
+
+        # @!attribute status
+        #
+        #   @return [Boolean]
+        required :status, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute group_name
+        #
+        #   @return [String, nil]
+        optional :group_name, String, nil?: true
+
+        # @!method initialize(group_id:, products:, status:, group_name: nil)
+        #   @param group_id [String]
+        #   @param products [Array<Dodopayments::Models::ProductCollectionRetrieveResponse::Group::Product>]
+        #   @param status [Boolean]
+        #   @param group_name [String, nil]
+
+        class Product < Dodopayments::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute addons_count
+          #
+          #   @return [Integer]
+          required :addons_count, Integer
+
+          # @!attribute files_count
+          #
+          #   @return [Integer]
+          required :files_count, Integer
+
+          # @!attribute has_credit_entitlements
+          #   Whether this product has any credit entitlements attached
+          #
+          #   @return [Boolean]
+          required :has_credit_entitlements, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute is_recurring
+          #
+          #   @return [Boolean]
+          required :is_recurring, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute license_key_enabled
+          #
+          #   @return [Boolean]
+          required :license_key_enabled, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute meters_count
+          #
+          #   @return [Integer]
+          required :meters_count, Integer
+
+          # @!attribute product_id
+          #
+          #   @return [String]
+          required :product_id, String
+
+          # @!attribute status
+          #
+          #   @return [Boolean]
+          required :status, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute currency
+          #
+          #   @return [Symbol, Dodopayments::Models::Currency, nil]
+          optional :currency, enum: -> { Dodopayments::Currency }, nil?: true
+
+          # @!attribute description
+          #
+          #   @return [String, nil]
+          optional :description, String, nil?: true
+
+          # @!attribute name
+          #
+          #   @return [String, nil]
+          optional :name, String, nil?: true
+
+          # @!attribute price
+          #
+          #   @return [Integer, nil]
+          optional :price, Integer, nil?: true
+
+          # @!attribute price_detail
+          #   One-time price details.
+          #
+          #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil]
+          optional :price_detail, union: -> { Dodopayments::Price }, nil?: true
+
+          # @!attribute tax_category
+          #   Represents the different categories of taxation applicable to various products
+          #   and services.
+          #
+          #   @return [Symbol, Dodopayments::Models::TaxCategory, nil]
+          optional :tax_category, enum: -> { Dodopayments::TaxCategory }, nil?: true
+
+          # @!attribute tax_inclusive
+          #
+          #   @return [Boolean, nil]
+          optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
+
+          # @!method initialize(id:, addons_count:, files_count:, has_credit_entitlements:, is_recurring:, license_key_enabled:, meters_count:, product_id:, status:, currency: nil, description: nil, name: nil, price: nil, price_detail: nil, tax_category: nil, tax_inclusive: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Dodopayments::Models::ProductCollectionRetrieveResponse::Group::Product} for
+          #   more details.
+          #
+          #   @param id [String]
+          #
+          #   @param addons_count [Integer]
+          #
+          #   @param files_count [Integer]
+          #
+          #   @param has_credit_entitlements [Boolean] Whether this product has any credit entitlements attached
+          #
+          #   @param is_recurring [Boolean]
+          #
+          #   @param license_key_enabled [Boolean]
+          #
+          #   @param meters_count [Integer]
+          #
+          #   @param product_id [String]
+          #
+          #   @param status [Boolean]
+          #
+          #   @param currency [Symbol, Dodopayments::Models::Currency, nil]
+          #
+          #   @param description [String, nil]
+          #
+          #   @param name [String, nil]
+          #
+          #   @param price [Integer, nil]
+          #
+          #   @param price_detail [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil] One-time price details.
+          #
+          #   @param tax_category [Symbol, Dodopayments::Models::TaxCategory, nil] Represents the different categories of taxation applicable to various products a
+          #
+          #   @param tax_inclusive [Boolean, nil]
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_unarchive_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#unarchive
+    class ProductCollectionUnarchiveParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_unarchive_response.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#unarchive
+    class ProductCollectionUnarchiveResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute collection_id
+      #   Collection ID that was unarchived
+      #
+      #   @return [String]
+      required :collection_id, String
+
+      # @!attribute excluded_product_ids
+      #   Product IDs that were excluded because they are archived
+      #
+      #   @return [Array<String>]
+      required :excluded_product_ids, Dodopayments::Internal::Type::ArrayOf[String]
+
+      # @!attribute message
+      #   Success message
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!method initialize(collection_id:, excluded_product_ids:, message:)
+      #   @param collection_id [String] Collection ID that was unarchived
+      #
+      #   @param excluded_product_ids [Array<String>] Product IDs that were excluded because they are archived
+      #
+      #   @param message [String] Success message
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_update_images_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#update_images
+    class ProductCollectionUpdateImagesParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute force_update
+      #   If true, generates a new image ID to force cache invalidation
+      #
+      #   @return [Boolean, nil]
+      optional :force_update, Dodopayments::Internal::Type::Boolean, nil?: true
+
+      # @!method initialize(id:, force_update: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param force_update [Boolean, nil] If true, generates a new image ID to force cache invalidation
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_update_images_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#update_images
+    class ProductCollectionUpdateImagesResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute url
+      #   Presigned S3 URL for uploading the image
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute image_id
+      #   Optional image ID (present when force_update is true)
+      #
+      #   @return [String, nil]
+      optional :image_id, String, nil?: true
+
+      # @!method initialize(url:, image_id: nil)
+      #   @param url [String] Presigned S3 URL for uploading the image
+      #
+      #   @param image_id [String, nil] Optional image ID (present when force_update is true)
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_update_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#update
+    class ProductCollectionUpdateParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute brand_id
+      #   Optional brand_id update
+      #
+      #   @return [String, nil]
+      optional :brand_id, String, nil?: true
+
+      # @!attribute description
+      #   Optional description update - pass null to remove, omit to keep unchanged
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute group_order
+      #   Optional new order for groups (array of group UUIDs in desired order)
+      #
+      #   @return [Array<String>, nil]
+      optional :group_order, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute image_id
+      #   Optional image update - pass null to remove, omit to keep unchanged
+      #
+      #   @return [String, nil]
+      optional :image_id, String, nil?: true
+
+      # @!attribute name
+      #   Optional new name for the collection
+      #
+      #   @return [String, nil]
+      optional :name, String, nil?: true
+
+      # @!method initialize(id:, brand_id: nil, description: nil, group_order: nil, image_id: nil, name: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param brand_id [String, nil] Optional brand_id update
+      #
+      #   @param description [String, nil] Optional description update - pass null to remove, omit to keep unchanged
+      #
+      #   @param group_order [Array<String>, nil] Optional new order for groups (array of group UUIDs in desired order)
+      #
+      #   @param image_id [String, nil] Optional image update - pass null to remove, omit to keep unchanged
+      #
+      #   @param name [String, nil] Optional new name for the collection
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/product_collections/group_create_params.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module ProductCollections
+      # @see Dodopayments::Resources::ProductCollections::Groups#create
+      class GroupCreateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute products
+        #   Products in this group
+        #
+        #   @return [Array<Dodopayments::Models::ProductCollections::GroupCreateParams::Product>]
+        required :products,
+                 -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::ProductCollections::GroupCreateParams::Product] }
+
+        # @!attribute group_name
+        #   Optional group name. Multiple groups can have null names, but named groups must
+        #   be unique per collection
+        #
+        #   @return [String, nil]
+        optional :group_name, String, nil?: true
+
+        # @!attribute status
+        #   Status of the group (defaults to true if not provided)
+        #
+        #   @return [Boolean, nil]
+        optional :status, Dodopayments::Internal::Type::Boolean, nil?: true
+
+        # @!method initialize(id:, products:, group_name: nil, status: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::ProductCollections::GroupCreateParams} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param products [Array<Dodopayments::Models::ProductCollections::GroupCreateParams::Product>] Products in this group
+        #
+        #   @param group_name [String, nil] Optional group name. Multiple groups can have null names, but named groups must
+        #
+        #   @param status [Boolean, nil] Status of the group (defaults to true if not provided)
+        #
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+
+        class Product < Dodopayments::Internal::Type::BaseModel
+          # @!attribute product_id
+          #   Product ID to include in the group
+          #
+          #   @return [String]
+          required :product_id, String
+
+          # @!attribute status
+          #   Status of the product in this group (defaults to true if not provided)
+          #
+          #   @return [Boolean, nil]
+          optional :status, Dodopayments::Internal::Type::Boolean, nil?: true
+
+          # @!method initialize(product_id:, status: nil)
+          #   @param product_id [String] Product ID to include in the group
+          #
+          #   @param status [Boolean, nil] Status of the product in this group (defaults to true if not provided)
+        end
+      end
+    end
+  end
+end