dodopayments 2.8.1 → 2.9.1

data/lib/dodopayments/models/entitlements/grant_list_params.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Entitlements
+      # @see Dodopayments::Resources::Entitlements::Grants#list
+      class GrantListParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute customer_id
+        #   Filter by customer ID
+        #
+        #   @return [String, nil]
+        optional :customer_id, String
+
+        # @!attribute page_number
+        #   Page number (default 0)
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   Page size (default 10, max 100)
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!attribute status
+        #   Filter by grant status
+        #
+        #   @return [Symbol, Dodopayments::Models::Entitlements::GrantListParams::Status, nil]
+        optional :status, enum: -> { Dodopayments::Entitlements::GrantListParams::Status }
+
+        # @!method initialize(id:, customer_id: nil, page_number: nil, page_size: nil, status: nil, request_options: {})
+        #   @param id [String]
+        #
+        #   @param customer_id [String] Filter by customer ID
+        #
+        #   @param page_number [Integer] Page number (default 0)
+        #
+        #   @param page_size [Integer] Page size (default 10, max 100)
+        #
+        #   @param status [Symbol, Dodopayments::Models::Entitlements::GrantListParams::Status] Filter by grant status
+        #
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+
+        # Filter by grant status
+        module Status
+          extend Dodopayments::Internal::Type::Enum
+
+          PENDING = :Pending
+          DELIVERED = :Delivered
+          FAILED = :Failed
+          REVOKED = :Revoked
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/models/entitlements/grant_revoke_params.rb

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

data/lib/dodopayments/models/entitlements/license_key_grant.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Entitlements
+      class LicenseKeyGrant < Dodopayments::Internal::Type::BaseModel
+        # @!attribute activations_used
+        #   Number of activations consumed so far.
+        #
+        #   @return [Integer]
+        required :activations_used, Integer
+
+        # @!attribute key
+        #   Issued license key.
+        #
+        #   @return [String]
+        required :key, String
+
+        # @!attribute activations_limit
+        #   Maximum activations allowed by the entitlement, when set.
+        #
+        #   @return [Integer, nil]
+        optional :activations_limit, Integer, nil?: true
+
+        # @!attribute expires_at
+        #   When the license key expires, when applicable.
+        #
+        #   @return [Time, nil]
+        optional :expires_at, Time, nil?: true
+
+        # @!method initialize(activations_used:, key:, activations_limit: nil, expires_at: nil)
+        #   License-key delivery payload, present on grants for `license_key` entitlements.
+        #   The grant's top-level `status` is the source of truth for the grant's lifecycle.
+        #
+        #   @param activations_used [Integer] Number of activations consumed so far.
+        #
+        #   @param key [String] Issued license key.
+        #
+        #   @param activations_limit [Integer, nil] Maximum activations allowed by the entitlement, when set.
+        #
+        #   @param expires_at [Time, nil] When the license key expires, when applicable.
+      end
+    end
+  end
+end

data/lib/dodopayments/models/integration_config.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # Integration-specific configuration supplied when creating or updating an
+    # entitlement. The shape required matches the entitlement's `integration_type`.
+    module IntegrationConfig
+      extend Dodopayments::Internal::Type::Union
+
+      variant -> { Dodopayments::IntegrationConfig::GitHubConfig }
+
+      variant -> { Dodopayments::IntegrationConfig::DiscordConfig }
+
+      variant -> { Dodopayments::IntegrationConfig::TelegramConfig }
+
+      variant -> { Dodopayments::IntegrationConfig::FigmaConfig }
+
+      variant -> { Dodopayments::IntegrationConfig::FramerConfig }
+
+      variant -> { Dodopayments::IntegrationConfig::NotionConfig }
+
+      variant -> { Dodopayments::IntegrationConfig::DigitalFilesConfig }
+
+      variant -> { Dodopayments::IntegrationConfig::LicenseKeyConfig }
+
+      class GitHubConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute permission
+        #   Permission to grant on the repository.
+        #
+        #   @return [Symbol, Dodopayments::Models::IntegrationConfig::GitHubConfig::Permission]
+        required :permission, enum: -> { Dodopayments::IntegrationConfig::GitHubConfig::Permission }
+
+        # @!attribute target_id
+        #   Repository or organisation slug to grant access to.
+        #
+        #   @return [String]
+        required :target_id, String
+
+        # @!method initialize(permission:, target_id:)
+        #   @param permission [Symbol, Dodopayments::Models::IntegrationConfig::GitHubConfig::Permission] Permission to grant on the repository.
+        #
+        #   @param target_id [String] Repository or organisation slug to grant access to.
+
+        # Permission to grant on the repository.
+        #
+        # @see Dodopayments::Models::IntegrationConfig::GitHubConfig#permission
+        module Permission
+          extend Dodopayments::Internal::Type::Enum
+
+          PULL = :pull
+          PUSH = :push
+          ADMIN = :admin
+          MAINTAIN = :maintain
+          TRIAGE = :triage
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class DiscordConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute guild_id
+        #   Discord guild (server) ID.
+        #
+        #   @return [String]
+        required :guild_id, String
+
+        # @!attribute role_id
+        #   Optional Discord role to assign within the guild.
+        #
+        #   @return [String, nil]
+        optional :role_id, String, nil?: true
+
+        # @!method initialize(guild_id:, role_id: nil)
+        #   @param guild_id [String] Discord guild (server) ID.
+        #
+        #   @param role_id [String, nil] Optional Discord role to assign within the guild.
+      end
+
+      class TelegramConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute chat_id
+        #   Telegram chat ID. For groups this is typically a negative integer.
+        #
+        #   @return [String]
+        required :chat_id, String
+
+        # @!method initialize(chat_id:)
+        #   @param chat_id [String] Telegram chat ID. For groups this is typically a negative integer.
+      end
+
+      class FigmaConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute figma_file_id
+        #   Figma file identifier to grant access to.
+        #
+        #   @return [String]
+        required :figma_file_id, String
+
+        # @!method initialize(figma_file_id:)
+        #   @param figma_file_id [String] Figma file identifier to grant access to.
+      end
+
+      class FramerConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute framer_template_id
+        #   Framer template identifier to grant access to.
+        #
+        #   @return [String]
+        required :framer_template_id, String
+
+        # @!method initialize(framer_template_id:)
+        #   @param framer_template_id [String] Framer template identifier to grant access to.
+      end
+
+      class NotionConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute notion_template_id
+        #   Notion template identifier to grant access to.
+        #
+        #   @return [String]
+        required :notion_template_id, String
+
+        # @!method initialize(notion_template_id:)
+        #   @param notion_template_id [String] Notion template identifier to grant access to.
+      end
+
+      class DigitalFilesConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute digital_file_ids
+        #   Files attached to this entitlement. Add files via
+        #   `POST /entitlements/{id}/files` and remove them via
+        #   `DELETE /entitlements/{id}/files/{file_id}`.
+        #
+        #   @return [Array<String>]
+        required :digital_file_ids, Dodopayments::Internal::Type::ArrayOf[String]
+
+        # @!attribute external_url
+        #   Optional external URL shown to the customer alongside the files.
+        #
+        #   @return [String, nil]
+        optional :external_url, String, nil?: true
+
+        # @!attribute instructions
+        #   Optional human-readable delivery instructions shown to the customer alongside
+        #   the files.
+        #
+        #   @return [String, nil]
+        optional :instructions, String, nil?: true
+
+        # @!attribute legacy_file_ids
+        #   Three-way patchable list of legacy file identifiers:
+        #
+        #   - omitted → preserve the current value
+        #   - `null` → clear
+        #   - `[...]` → replace
+        #
+        #   On create, an omitted field, an explicit `null`, or an empty array all result in
+        #   no legacy files attached.
+        #
+        #   @return [Array<String>, nil]
+        optional :legacy_file_ids, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(digital_file_ids:, external_url: nil, instructions: nil, legacy_file_ids: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::IntegrationConfig::DigitalFilesConfig} for more details.
+        #
+        #   @param digital_file_ids [Array<String>] Files attached to this entitlement. Add files via
+        #
+        #   @param external_url [String, nil] Optional external URL shown to the customer alongside the files.
+        #
+        #   @param instructions [String, nil] Optional human-readable delivery instructions shown to the customer
+        #
+        #   @param legacy_file_ids [Array<String>, nil] Three-way patchable list of legacy file identifiers:
+      end
+
+      class LicenseKeyConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute activation_message
+        #   Optional message displayed when a customer activates the license key (≤ 2500
+        #   characters).
+        #
+        #   @return [String, nil]
+        optional :activation_message, String, nil?: true
+
+        # @!attribute activations_limit
+        #   Maximum activations allowed per issued license key. Omit for unlimited.
+        #
+        #   @return [Integer, nil]
+        optional :activations_limit, Integer, nil?: true
+
+        # @!attribute duration_count
+        #   Validity duration of issued license keys. Provide both `duration_count` and
+        #   `duration_interval` together for a fixed duration; omit both for non-expiring
+        #   keys.
+        #
+        #   @return [Integer, nil]
+        optional :duration_count, Integer, nil?: true
+
+        # @!attribute duration_interval
+        #   Unit of `duration_count`.
+        #
+        #   @return [Symbol, Dodopayments::Models::TimeInterval, nil]
+        optional :duration_interval, enum: -> { Dodopayments::TimeInterval }, nil?: true
+
+        # @!method initialize(activation_message: nil, activations_limit: nil, duration_count: nil, duration_interval: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::IntegrationConfig::LicenseKeyConfig} for more details.
+        #
+        #   @param activation_message [String, nil] Optional message displayed when a customer activates the license
+        #
+        #   @param activations_limit [Integer, nil] Maximum activations allowed per issued license key. Omit for unlimited.
+        #
+        #   @param duration_count [Integer, nil] Validity duration of issued license keys. Provide both
+        #
+        #   @param duration_interval [Symbol, Dodopayments::Models::TimeInterval, nil] Unit of `duration_count`.
+      end
+
+      # @!method self.variants
+      #   @return [Array(Dodopayments::Models::IntegrationConfig::GitHubConfig, Dodopayments::Models::IntegrationConfig::DiscordConfig, Dodopayments::Models::IntegrationConfig::TelegramConfig, Dodopayments::Models::IntegrationConfig::FigmaConfig, Dodopayments::Models::IntegrationConfig::FramerConfig, Dodopayments::Models::IntegrationConfig::NotionConfig, Dodopayments::Models::IntegrationConfig::DigitalFilesConfig, Dodopayments::Models::IntegrationConfig::LicenseKeyConfig)]
+    end
+  end
+end

data/lib/dodopayments/models/integration_config_response.rb

@@ -0,0 +1,278 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # Integration-specific configuration on an entitlement read response.
+    #
+    # For `digital_files` entitlements the response includes presigned download URLs
+    # for each attached file; other integrations match the shape supplied at creation.
+    module IntegrationConfigResponse
+      extend Dodopayments::Internal::Type::Union
+
+      variant -> { Dodopayments::IntegrationConfigResponse::GitHubConfig }
+
+      variant -> { Dodopayments::IntegrationConfigResponse::DiscordConfig }
+
+      variant -> { Dodopayments::IntegrationConfigResponse::TelegramConfig }
+
+      variant -> { Dodopayments::IntegrationConfigResponse::FigmaConfig }
+
+      variant -> { Dodopayments::IntegrationConfigResponse::FramerConfig }
+
+      variant -> { Dodopayments::IntegrationConfigResponse::NotionConfig }
+
+      variant -> { Dodopayments::IntegrationConfigResponse::DigitalFilesConfig }
+
+      variant -> { Dodopayments::IntegrationConfigResponse::LicenseKeyConfig }
+
+      class GitHubConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute permission
+        #   Permission to grant on the repository.
+        #
+        #   @return [Symbol, Dodopayments::Models::IntegrationConfigResponse::GitHubConfig::Permission]
+        required :permission, enum: -> { Dodopayments::IntegrationConfigResponse::GitHubConfig::Permission }
+
+        # @!attribute target_id
+        #   Repository or organisation slug to grant access to.
+        #
+        #   @return [String]
+        required :target_id, String
+
+        # @!method initialize(permission:, target_id:)
+        #   @param permission [Symbol, Dodopayments::Models::IntegrationConfigResponse::GitHubConfig::Permission] Permission to grant on the repository.
+        #
+        #   @param target_id [String] Repository or organisation slug to grant access to.
+
+        # Permission to grant on the repository.
+        #
+        # @see Dodopayments::Models::IntegrationConfigResponse::GitHubConfig#permission
+        module Permission
+          extend Dodopayments::Internal::Type::Enum
+
+          PULL = :pull
+          PUSH = :push
+          ADMIN = :admin
+          MAINTAIN = :maintain
+          TRIAGE = :triage
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class DiscordConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute guild_id
+        #   Discord guild (server) ID.
+        #
+        #   @return [String]
+        required :guild_id, String
+
+        # @!attribute role_id
+        #   Optional Discord role to assign within the guild.
+        #
+        #   @return [String, nil]
+        optional :role_id, String, nil?: true
+
+        # @!method initialize(guild_id:, role_id: nil)
+        #   @param guild_id [String] Discord guild (server) ID.
+        #
+        #   @param role_id [String, nil] Optional Discord role to assign within the guild.
+      end
+
+      class TelegramConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute chat_id
+        #   Telegram chat ID. For groups this is typically a negative integer.
+        #
+        #   @return [String]
+        required :chat_id, String
+
+        # @!method initialize(chat_id:)
+        #   @param chat_id [String] Telegram chat ID. For groups this is typically a negative integer.
+      end
+
+      class FigmaConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute figma_file_id
+        #   Figma file identifier to grant access to.
+        #
+        #   @return [String]
+        required :figma_file_id, String
+
+        # @!method initialize(figma_file_id:)
+        #   @param figma_file_id [String] Figma file identifier to grant access to.
+      end
+
+      class FramerConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute framer_template_id
+        #   Framer template identifier to grant access to.
+        #
+        #   @return [String]
+        required :framer_template_id, String
+
+        # @!method initialize(framer_template_id:)
+        #   @param framer_template_id [String] Framer template identifier to grant access to.
+      end
+
+      class NotionConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute notion_template_id
+        #   Notion template identifier to grant access to.
+        #
+        #   @return [String]
+        required :notion_template_id, String
+
+        # @!method initialize(notion_template_id:)
+        #   @param notion_template_id [String] Notion template identifier to grant access to.
+      end
+
+      class DigitalFilesConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute digital_files
+        #   Populated digital-files payload with each file's metadata and a short-lived
+        #   presigned download URL.
+        #
+        #   @return [Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles]
+        required :digital_files, -> { Dodopayments::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles }
+
+        # @!method initialize(digital_files:)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig} for more
+        #   details.
+        #
+        #   @param digital_files [Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles] Populated digital-files payload with each file's metadata and a
+
+        # @see Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig#digital_files
+        class DigitalFiles < Dodopayments::Internal::Type::BaseModel
+          # @!attribute files
+          #   One entry per attached file.
+          #
+          #   @return [Array<Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File>]
+          required :files,
+                   -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File] }
+
+          # @!attribute external_url
+          #   Optional external URL, passed through from the entitlement configuration.
+          #
+          #   @return [String, nil]
+          optional :external_url, String, nil?: true
+
+          # @!attribute instructions
+          #   Optional human-readable delivery instructions, passed through from the
+          #   entitlement configuration.
+          #
+          #   @return [String, nil]
+          optional :instructions, String, nil?: true
+
+          # @!method initialize(files:, external_url: nil, instructions: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles}
+          #   for more details.
+          #
+          #   Populated digital-files payload with each file's metadata and a short-lived
+          #   presigned download URL.
+          #
+          #   @param files [Array<Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File>] One entry per attached file.
+          #
+          #   @param external_url [String, nil] Optional external URL, passed through from the entitlement
+          #
+          #   @param instructions [String, nil] Optional human-readable delivery instructions, passed through from
+
+          class File < Dodopayments::Internal::Type::BaseModel
+            # @!attribute download_url
+            #   Short-lived presigned URL for downloading the file.
+            #
+            #   @return [String]
+            required :download_url, String
+
+            # @!attribute expires_in
+            #   Seconds until `download_url` expires.
+            #
+            #   @return [Integer]
+            required :expires_in, Integer
+
+            # @!attribute file_id
+            #   Identifier of the attached file.
+            #
+            #   @return [String]
+            required :file_id, String
+
+            # @!attribute filename
+            #   Original filename of the attached file.
+            #
+            #   @return [String]
+            required :filename, String
+
+            # @!attribute content_type
+            #   Optional content-type declared at upload.
+            #
+            #   @return [String, nil]
+            optional :content_type, String, nil?: true
+
+            # @!attribute file_size
+            #   Optional size of the file in bytes.
+            #
+            #   @return [Integer, nil]
+            optional :file_size, Integer, nil?: true
+
+            # @!method initialize(download_url:, expires_in:, file_id:, filename:, content_type: nil, file_size: nil)
+            #   One file in a resolved digital-files payload.
+            #
+            #   @param download_url [String] Short-lived presigned URL for downloading the file.
+            #
+            #   @param expires_in [Integer] Seconds until `download_url` expires.
+            #
+            #   @param file_id [String] Identifier of the attached file.
+            #
+            #   @param filename [String] Original filename of the attached file.
+            #
+            #   @param content_type [String, nil] Optional content-type declared at upload.
+            #
+            #   @param file_size [Integer, nil] Optional size of the file in bytes.
+          end
+        end
+      end
+
+      class LicenseKeyConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute activation_message
+        #   Optional message displayed when a customer activates the license key (≤ 2500
+        #   characters).
+        #
+        #   @return [String, nil]
+        optional :activation_message, String, nil?: true
+
+        # @!attribute activations_limit
+        #   Maximum activations allowed per issued license key. Omit for unlimited.
+        #
+        #   @return [Integer, nil]
+        optional :activations_limit, Integer, nil?: true
+
+        # @!attribute duration_count
+        #   Validity duration of issued license keys. Provide both `duration_count` and
+        #   `duration_interval` together for a fixed duration; omit both for non-expiring
+        #   keys.
+        #
+        #   @return [Integer, nil]
+        optional :duration_count, Integer, nil?: true
+
+        # @!attribute duration_interval
+        #   Unit of `duration_count`.
+        #
+        #   @return [Symbol, Dodopayments::Models::TimeInterval, nil]
+        optional :duration_interval, enum: -> { Dodopayments::TimeInterval }, nil?: true
+
+        # @!method initialize(activation_message: nil, activations_limit: nil, duration_count: nil, duration_interval: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::IntegrationConfigResponse::LicenseKeyConfig} for more
+        #   details.
+        #
+        #   @param activation_message [String, nil] Optional message displayed when a customer activates the license
+        #
+        #   @param activations_limit [Integer, nil] Maximum activations allowed per issued license key. Omit for unlimited.
+        #
+        #   @param duration_count [Integer, nil] Validity duration of issued license keys. Provide both
+        #
+        #   @param duration_interval [Symbol, Dodopayments::Models::TimeInterval, nil] Unit of `duration_count`.
+      end
+
+      # @!method self.variants
+      #   @return [Array(Dodopayments::Models::IntegrationConfigResponse::GitHubConfig, Dodopayments::Models::IntegrationConfigResponse::DiscordConfig, Dodopayments::Models::IntegrationConfigResponse::TelegramConfig, Dodopayments::Models::IntegrationConfigResponse::FigmaConfig, Dodopayments::Models::IntegrationConfigResponse::FramerConfig, Dodopayments::Models::IntegrationConfigResponse::NotionConfig, Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig, Dodopayments::Models::IntegrationConfigResponse::LicenseKeyConfig)]
+    end
+  end
+end

data/lib/dodopayments/models/license_key_instance_list_params.rb

@@ -7,6 +7,12 @@ module Dodopayments
       extend Dodopayments::Internal::Type::RequestParameters::Converter
       include Dodopayments::Internal::Type::RequestParameters
 
+      # @!attribute grant_id
+      #   Filter instances by entitlement grant ID
+      #
+      #   @return [String, nil]
+      optional :grant_id, String, nil?: true
+
       # @!attribute license_key_id
       #   Filter by license key ID
       #
@@ -25,7 +31,9 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :page_size, Integer, nil?: true
 
-      # @!method initialize(license_key_id: nil, page_number: nil, page_size: nil, request_options: {})
+      # @!method initialize(grant_id: nil, license_key_id: nil, page_number: nil, page_size: nil, request_options: {})
+      #   @param grant_id [String, nil] Filter instances by entitlement grant ID
+      #
       #   @param license_key_id [String, nil] Filter by license key ID
       #
       #   @param page_number [Integer, nil] Page number default is 0

data/lib/dodopayments/models/one_time_product_cart_item.rb

@@ -13,9 +13,23 @@ module Dodopayments
       #   @return [Integer]
       required :quantity, Integer
 
-      # @!method initialize(product_id:, quantity:)
+      # @!attribute amount
+      #   Amount the customer pays if pay_what_you_want is enabled. If disabled then
+      #   amount will be ignored Represented in the lowest denomination of the currency
+      #   (e.g., cents for USD). For example, to charge $1.00, pass `100`.
+      #
+      #   @return [Integer, nil]
+      optional :amount, Integer, nil?: true
+
+      # @!method initialize(product_id:, quantity:, amount: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::OneTimeProductCartItem} for more details.
+      #
       #   @param product_id [String]
+      #
       #   @param quantity [Integer]
+      #
+      #   @param amount [Integer, nil] Amount the customer pays if pay_what_you_want is enabled. If disabled then amoun
     end
   end
 end