dodopayments 2.6.0 → 2.7.0

data/lib/dodopayments/models/product_list_response.rb

@@ -16,6 +16,13 @@ module Dodopayments
       #   @return [Time]
       required :created_at, Time
 
+      # @!attribute entitlements
+      #   Entitlements linked to this product
+      #
+      #   @return [Array<Dodopayments::Models::ProductListResponse::Entitlement>]
+      required :entitlements,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::ProductListResponse::Entitlement] }
+
       # @!attribute is_recurring
       #   Indicates if the product is recurring (e.g., subscriptions).
       #
@@ -97,7 +104,7 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
 
-      # @!method initialize(business_id:, created_at:, is_recurring:, metadata:, product_id:, tax_category:, updated_at:, currency: nil, description: nil, image: nil, name: nil, price: nil, price_detail: nil, tax_inclusive: nil)
+      # @!method initialize(business_id:, created_at:, entitlements:, is_recurring:, metadata:, product_id:, tax_category:, updated_at:, currency: nil, description: nil, image: nil, name: nil, price: nil, price_detail: nil, tax_inclusive: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::ProductListResponse} for more details.
       #
@@ -105,6 +112,8 @@ module Dodopayments
       #
       #   @param created_at [Time] Timestamp when the product was created.
       #
+      #   @param entitlements [Array<Dodopayments::Models::ProductListResponse::Entitlement>] Entitlements linked to this product
+      #
       #   @param is_recurring [Boolean] Indicates if the product is recurring (e.g., subscriptions).
       #
       #   @param metadata [Hash{Symbol=>String}] Additional custom data associated with the product
@@ -128,6 +137,221 @@ module Dodopayments
       #   @param price_detail [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil] Details of the price
       #
       #   @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
+
+      class Entitlement < Dodopayments::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute integration_config
+        #   Platform-specific configuration for an entitlement. Each variant uses unique
+        #   field names so `#[serde(untagged)]` can disambiguate correctly.
+        #
+        #   @return [Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::GitHubConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DiscordConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::TelegramConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FigmaConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FramerConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::NotionConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DigitalFilesConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::LicenseKeyConfig]
+        required :integration_config,
+                 union: -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig }
+
+        # @!attribute integration_type
+        #
+        #   @return [Symbol, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationType]
+        required :integration_type,
+                 enum: -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationType }
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!method initialize(id:, integration_config:, integration_type:, name:, description: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::ProductListResponse::Entitlement} for more details.
+        #
+        #   Summary of an entitlement attached to a product
+        #
+        #   @param id [String]
+        #
+        #   @param integration_config [Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::GitHubConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DiscordConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::TelegramConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FigmaConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FramerConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::NotionConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DigitalFilesConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::LicenseKeyConfig] Platform-specific configuration for an entitlement.
+        #
+        #   @param integration_type [Symbol, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationType]
+        #
+        #   @param name [String]
+        #
+        #   @param description [String, nil]
+
+        # Platform-specific configuration for an entitlement. Each variant uses unique
+        # field names so `#[serde(untagged)]` can disambiguate correctly.
+        #
+        # @see Dodopayments::Models::ProductListResponse::Entitlement#integration_config
+        module IntegrationConfig
+          extend Dodopayments::Internal::Type::Union
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::GitHubConfig }
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DiscordConfig }
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::TelegramConfig }
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FigmaConfig }
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FramerConfig }
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::NotionConfig }
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DigitalFilesConfig }
+
+          variant -> { Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::LicenseKeyConfig }
+
+          class GitHubConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute permission
+            #   One of: pull, push, admin, maintain, triage
+            #
+            #   @return [String]
+            required :permission, String
+
+            # @!attribute target_id
+            #
+            #   @return [String]
+            required :target_id, String
+
+            # @!method initialize(permission:, target_id:)
+            #   @param permission [String] One of: pull, push, admin, maintain, triage
+            #
+            #   @param target_id [String]
+          end
+
+          class DiscordConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute guild_id
+            #
+            #   @return [String]
+            required :guild_id, String
+
+            # @!attribute role_id
+            #
+            #   @return [String, nil]
+            optional :role_id, String, nil?: true
+
+            # @!method initialize(guild_id:, role_id: nil)
+            #   @param guild_id [String]
+            #   @param role_id [String, nil]
+          end
+
+          class TelegramConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute chat_id
+            #
+            #   @return [String]
+            required :chat_id, String
+
+            # @!method initialize(chat_id:)
+            #   @param chat_id [String]
+          end
+
+          class FigmaConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute figma_file_id
+            #
+            #   @return [String]
+            required :figma_file_id, String
+
+            # @!method initialize(figma_file_id:)
+            #   @param figma_file_id [String]
+          end
+
+          class FramerConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute framer_template_id
+            #
+            #   @return [String]
+            required :framer_template_id, String
+
+            # @!method initialize(framer_template_id:)
+            #   @param framer_template_id [String]
+          end
+
+          class NotionConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute notion_template_id
+            #
+            #   @return [String]
+            required :notion_template_id, String
+
+            # @!method initialize(notion_template_id:)
+            #   @param notion_template_id [String]
+          end
+
+          class DigitalFilesConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute digital_file_ids
+            #
+            #   @return [Array<String>]
+            required :digital_file_ids, Dodopayments::Internal::Type::ArrayOf[String]
+
+            # @!attribute external_url
+            #
+            #   @return [String, nil]
+            optional :external_url, String, nil?: true
+
+            # @!attribute instructions
+            #
+            #   @return [String, nil]
+            optional :instructions, String, nil?: true
+
+            # @!method initialize(digital_file_ids:, external_url: nil, instructions: nil)
+            #   @param digital_file_ids [Array<String>]
+            #   @param external_url [String, nil]
+            #   @param instructions [String, nil]
+          end
+
+          class LicenseKeyConfig < Dodopayments::Internal::Type::BaseModel
+            # @!attribute activation_message
+            #
+            #   @return [String, nil]
+            optional :activation_message, String, nil?: true
+
+            # @!attribute activations_limit
+            #
+            #   @return [Integer, nil]
+            optional :activations_limit, Integer, nil?: true
+
+            # @!attribute duration_count
+            #
+            #   @return [Integer, nil]
+            optional :duration_count, Integer, nil?: true
+
+            # @!attribute duration_interval
+            #
+            #   @return [String, nil]
+            optional :duration_interval, String, nil?: true
+
+            # @!method initialize(activation_message: nil, activations_limit: nil, duration_count: nil, duration_interval: nil)
+            #   @param activation_message [String, nil]
+            #   @param activations_limit [Integer, nil]
+            #   @param duration_count [Integer, nil]
+            #   @param duration_interval [String, nil]
+          end
+
+          # @!method self.variants
+          #   @return [Array(Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::GitHubConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DiscordConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::TelegramConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FigmaConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::FramerConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::NotionConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::DigitalFilesConfig, Dodopayments::Models::ProductListResponse::Entitlement::IntegrationConfig::LicenseKeyConfig)]
+        end
+
+        # @see Dodopayments::Models::ProductListResponse::Entitlement#integration_type
+        module IntegrationType
+          extend Dodopayments::Internal::Type::Enum
+
+          DISCORD = :discord
+          TELEGRAM = :telegram
+          GITHUB = :github
+          FIGMA = :figma
+          FRAMER = :framer
+          NOTION = :notion
+          DIGITAL_FILES = :digital_files
+          LICENSE_KEY = :license_key
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end

data/lib/dodopayments/models/product_update_params.rb

@@ -46,6 +46,13 @@ module Dodopayments
                -> { Dodopayments::ProductUpdateParams::DigitalProductDelivery },
                nil?: true
 
+      # @!attribute entitlement_ids
+      #   Entitlement IDs to attach (replaces all existing when present) Send empty array
+      #   to remove all, omit field to leave unchanged
+      #
+      #   @return [Array<String>, nil]
+      optional :entitlement_ids, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
+
       # @!attribute image_id
       #   Product image id after its uploaded to S3
       #
@@ -53,6 +60,8 @@ module Dodopayments
       optional :image_id, String, nil?: true
 
       # @!attribute license_key_activation_message
+      #   @deprecated
+      #
       #   Message sent to the customer upon license key activation.
       #
       #   Only applicable if `license_key_enabled` is `true`. This message contains
@@ -62,6 +71,8 @@ module Dodopayments
       optional :license_key_activation_message, String, nil?: true
 
       # @!attribute license_key_activations_limit
+      #   @deprecated
+      #
       #   Limit for the number of activations for the license key.
       #
       #   Only applicable if `license_key_enabled` is `true`. Represents the maximum
@@ -80,6 +91,8 @@ module Dodopayments
       optional :license_key_duration, -> { Dodopayments::LicenseKeyDuration }, nil?: true
 
       # @!attribute license_key_enabled
+      #   @deprecated
+      #
       #   Whether the product requires a license key.
       #
       #   If `true`, additional fields related to license key (duration, activations
@@ -112,7 +125,7 @@ module Dodopayments
       #   @return [Symbol, Dodopayments::Models::TaxCategory, nil]
       optional :tax_category, enum: -> { Dodopayments::TaxCategory }, nil?: true
 
-      # @!method initialize(id:, addons: nil, brand_id: nil, credit_entitlements: nil, description: nil, digital_product_delivery: nil, image_id: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, metadata: nil, name: nil, price: nil, tax_category: nil, request_options: {})
+      # @!method initialize(id:, addons: nil, brand_id: nil, credit_entitlements: nil, description: nil, digital_product_delivery: nil, entitlement_ids: nil, image_id: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, metadata: nil, name: nil, price: nil, tax_category: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::ProductUpdateParams} for more details.
       #
@@ -128,6 +141,8 @@ module Dodopayments
       #
       #   @param digital_product_delivery [Dodopayments::Models::ProductUpdateParams::DigitalProductDelivery, nil] Choose how you would like you digital product delivered
       #
+      #   @param entitlement_ids [Array<String>, nil] Entitlement IDs to attach (replaces all existing when present)
+      #
       #   @param image_id [String, nil] Product image id after its uploaded to S3
       #
       #   @param license_key_activation_message [String, nil] Message sent to the customer upon license key activation.

data/lib/dodopayments/models/webhook_event_type.rb

@@ -47,6 +47,10 @@ module Dodopayments
       DUNNING_RECOVERED = :"dunning.recovered"
       ACR_EMAIL = :"acr.email"
       DUNNING_EMAIL = :"dunning.email"
+      ENTITLEMENT_GRANT_CREATED = :"entitlement_grant.created"
+      ENTITLEMENT_GRANT_DELIVERED = :"entitlement_grant.delivered"
+      ENTITLEMENT_GRANT_FAILED = :"entitlement_grant.failed"
+      ENTITLEMENT_GRANT_REVOKED = :"entitlement_grant.revoked"
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/dodopayments/models/webhook_payload.rb

@@ -11,7 +11,7 @@ module Dodopayments
       # @!attribute data
       #   The latest data at the time of delivery attempt
       #
-      #   @return [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt]
+      #   @return [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt, Dodopayments::Models::WebhookPayload::Data::EntitlementGrant]
       required :data, union: -> { Dodopayments::WebhookPayload::Data }
 
       # @!attribute timestamp
@@ -33,7 +33,7 @@ module Dodopayments
       #
       #   @param business_id [String]
       #
-      #   @param data [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt] The latest data at the time of delivery attempt
+      #   @param data [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt, Dodopayments::Models::WebhookPayload::Data::EntitlementGrant] The latest data at the time of delivery attempt
       #
       #   @param timestamp [Time] The timestamp of when the event occurred (not necessarily the same of when it wa
       #
@@ -65,6 +65,8 @@ module Dodopayments
 
         variant -> { Dodopayments::WebhookPayload::Data::DunningAttempt }
 
+        variant -> { Dodopayments::WebhookPayload::Data::EntitlementGrant }
+
         class Payment < Dodopayments::Models::Payment
           # @!attribute payload_type
           #
@@ -412,8 +414,179 @@ module Dodopayments
           end
         end
 
+        class EntitlementGrant < Dodopayments::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute business_id
+          #
+          #   @return [String]
+          required :business_id, String
+
+          # @!attribute created_at
+          #
+          #   @return [Time]
+          required :created_at, Time
+
+          # @!attribute customer_id
+          #
+          #   @return [String]
+          required :customer_id, String
+
+          # @!attribute entitlement_id
+          #
+          #   @return [String]
+          required :entitlement_id, String
+
+          # @!attribute external_id
+          #
+          #   @return [String]
+          required :external_id, String
+
+          # @!attribute payload_type
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::EntitlementGrant::PayloadType]
+          required :payload_type, enum: -> { Dodopayments::WebhookPayload::Data::EntitlementGrant::PayloadType }
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::EntitlementGrant::Status]
+          required :status, enum: -> { Dodopayments::WebhookPayload::Data::EntitlementGrant::Status }
+
+          # @!attribute updated_at
+          #
+          #   @return [Time]
+          required :updated_at, Time
+
+          # @!attribute delivered_at
+          #
+          #   @return [Time, nil]
+          optional :delivered_at, Time, nil?: true
+
+          # @!attribute error_code
+          #
+          #   @return [String, nil]
+          optional :error_code, String, nil?: true
+
+          # @!attribute error_message
+          #
+          #   @return [String, nil]
+          optional :error_message, String, nil?: true
+
+          # @!attribute license_key
+          #
+          #   @return [String, nil]
+          optional :license_key, String, nil?: true
+
+          # @!attribute license_key_activations_limit
+          #
+          #   @return [Integer, nil]
+          optional :license_key_activations_limit, Integer, nil?: true
+
+          # @!attribute license_key_activations_used
+          #
+          #   @return [Integer, nil]
+          optional :license_key_activations_used, Integer, nil?: true
+
+          # @!attribute license_key_expires_at
+          #
+          #   @return [Time, nil]
+          optional :license_key_expires_at, Time, nil?: true
+
+          # @!attribute license_key_status
+          #
+          #   @return [String, nil]
+          optional :license_key_status, String, nil?: true
+
+          # @!attribute metadata
+          #
+          #   @return [Object, nil]
+          optional :metadata, Dodopayments::Internal::Type::Unknown
+
+          # @!attribute oauth_expires_at
+          #
+          #   @return [Time, nil]
+          optional :oauth_expires_at, Time, nil?: true
+
+          # @!attribute oauth_url
+          #
+          #   @return [String, nil]
+          optional :oauth_url, String, nil?: true
+
+          # @!attribute payment_id
+          #
+          #   @return [String, nil]
+          optional :payment_id, String, nil?: true
+
+          # @!attribute revocation_reason
+          #
+          #   @return [String, nil]
+          optional :revocation_reason, String, nil?: true
+
+          # @!attribute revoked_at
+          #
+          #   @return [Time, nil]
+          optional :revoked_at, Time, nil?: true
+
+          # @!attribute subscription_id
+          #
+          #   @return [String, nil]
+          optional :subscription_id, String, nil?: true
+
+          # @!method initialize(id:, business_id:, created_at:, customer_id:, entitlement_id:, external_id:, payload_type:, status:, updated_at:, delivered_at: nil, error_code: nil, error_message: nil, license_key: nil, license_key_activations_limit: nil, license_key_activations_used: nil, license_key_expires_at: nil, license_key_status: nil, metadata: nil, oauth_expires_at: nil, oauth_url: nil, payment_id: nil, revocation_reason: nil, revoked_at: nil, subscription_id: nil)
+          #   @param id [String]
+          #   @param business_id [String]
+          #   @param created_at [Time]
+          #   @param customer_id [String]
+          #   @param entitlement_id [String]
+          #   @param external_id [String]
+          #   @param payload_type [Symbol, Dodopayments::Models::WebhookPayload::Data::EntitlementGrant::PayloadType]
+          #   @param status [Symbol, Dodopayments::Models::WebhookPayload::Data::EntitlementGrant::Status]
+          #   @param updated_at [Time]
+          #   @param delivered_at [Time, nil]
+          #   @param error_code [String, nil]
+          #   @param error_message [String, nil]
+          #   @param license_key [String, nil]
+          #   @param license_key_activations_limit [Integer, nil]
+          #   @param license_key_activations_used [Integer, nil]
+          #   @param license_key_expires_at [Time, nil]
+          #   @param license_key_status [String, nil]
+          #   @param metadata [Object]
+          #   @param oauth_expires_at [Time, nil]
+          #   @param oauth_url [String, nil]
+          #   @param payment_id [String, nil]
+          #   @param revocation_reason [String, nil]
+          #   @param revoked_at [Time, nil]
+          #   @param subscription_id [String, nil]
+
+          # @see Dodopayments::Models::WebhookPayload::Data::EntitlementGrant#payload_type
+          module PayloadType
+            extend Dodopayments::Internal::Type::Enum
+
+            ENTITLEMENT_GRANT = :EntitlementGrant
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Dodopayments::Models::WebhookPayload::Data::EntitlementGrant#status
+          module Status
+            extend Dodopayments::Internal::Type::Enum
+
+            PENDING = :Pending
+            DELIVERED = :Delivered
+            FAILED = :Failed
+            REVOKED = :Revoked
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         # @!method self.variants
-        #   @return [Array(Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt)]
+        #   @return [Array(Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt, Dodopayments::Models::WebhookPayload::Data::EntitlementGrant)]
       end
     end
   end

data/lib/dodopayments/models.rb

@@ -245,6 +245,8 @@ module Dodopayments
 
   LicenseKeyCreatedWebhookEvent = Dodopayments::Models::LicenseKeyCreatedWebhookEvent
 
+  LicenseKeyCreateParams = Dodopayments::Models::LicenseKeyCreateParams
+
   LicenseKeyDuration = Dodopayments::Models::LicenseKeyDuration
 
   LicenseKeyInstance = Dodopayments::Models::LicenseKeyInstance

data/lib/dodopayments/resources/license_keys.rb

@@ -3,6 +3,36 @@
 module Dodopayments
   module Resources
     class LicenseKeys
+      # @overload create(customer_id:, key:, product_id:, activations_limit: nil, expires_at: nil, request_options: {})
+      #
+      # @param customer_id [String] The customer this license key belongs to.
+      #
+      # @param key [String] The license key string to import.
+      #
+      # @param product_id [String] The product this license key is for.
+      #
+      # @param activations_limit [Integer, nil] Maximum number of activations allowed. Null means unlimited.
+      #
+      # @param expires_at [Time, nil] Expiration timestamp. Null means the key never expires.
+      #
+      # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Dodopayments::Models::LicenseKey]
+      #
+      # @see Dodopayments::Models::LicenseKeyCreateParams
+      def create(params)
+        parsed, options = Dodopayments::LicenseKeyCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "license_keys",
+          body: parsed,
+          model: Dodopayments::LicenseKey,
+          options: options
+        )
+      end
+
+      # @deprecated
+      #
       # @overload retrieve(id, request_options: {})
       #
       # @param id [String] License key ID
@@ -21,6 +51,8 @@ module Dodopayments
         )
       end
 
+      # @deprecated
+      #
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::LicenseKeyUpdateParams} for more details.
       #
@@ -50,7 +82,9 @@ module Dodopayments
         )
       end
 
-      # @overload list(created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, request_options: {})
+      # @deprecated
+      #
+      # @overload list(created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, source: nil, status: nil, request_options: {})
       #
       # @param created_at_gte [Time] Filter license keys created on or after this timestamp
       #
@@ -64,6 +98,8 @@ module Dodopayments
       #
       # @param product_id [String] Filter by product ID
       #
+      # @param source [Symbol, Dodopayments::Models::LicenseKeyListParams::Source] Filter by license key source
+      #
       # @param status [Symbol, Dodopayments::Models::LicenseKeyListParams::Status] Filter by license key status
       #
       # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/dodopayments/resources/products.rb

@@ -12,7 +12,7 @@ module Dodopayments
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::ProductCreateParams} for more details.
       #
-      # @overload create(name:, price:, tax_category:, addons: nil, brand_id: nil, credit_entitlements: nil, description: nil, digital_product_delivery: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, metadata: nil, request_options: {})
+      # @overload create(name:, price:, tax_category:, addons: nil, brand_id: nil, credit_entitlements: nil, description: nil, digital_product_delivery: nil, entitlement_ids: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, metadata: nil, request_options: {})
       #
       # @param name [String] Name of the product
       #
@@ -30,6 +30,8 @@ module Dodopayments
       #
       # @param digital_product_delivery [Dodopayments::Models::ProductCreateParams::DigitalProductDelivery, nil] Choose how you would like you digital product delivered
       #
+      # @param entitlement_ids [Array<String>, nil] Optional entitlement IDs to attach to this product (max 20)
+      #
       # @param license_key_activation_message [String, nil] Optional message displayed during license key activation
       #
       # @param license_key_activations_limit [Integer, nil] The number of times the license key can be activated.
@@ -77,7 +79,7 @@ module Dodopayments
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::ProductUpdateParams} for more details.
       #
-      # @overload update(id, addons: nil, brand_id: nil, credit_entitlements: nil, description: nil, digital_product_delivery: nil, image_id: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, metadata: nil, name: nil, price: nil, tax_category: nil, request_options: {})
+      # @overload update(id, addons: nil, brand_id: nil, credit_entitlements: nil, description: nil, digital_product_delivery: nil, entitlement_ids: nil, image_id: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, metadata: nil, name: nil, price: nil, tax_category: nil, request_options: {})
       #
       # @param id [String]
       #
@@ -91,6 +93,8 @@ module Dodopayments
       #
       # @param digital_product_delivery [Dodopayments::Models::ProductUpdateParams::DigitalProductDelivery, nil] Choose how you would like you digital product delivered
       #
+      # @param entitlement_ids [Array<String>, nil] Entitlement IDs to attach (replaces all existing when present)
+      #
       # @param image_id [String, nil] Product image id after its uploaded to S3
       #
       # @param license_key_activation_message [String, nil] Message sent to the customer upon license key activation.

data/lib/dodopayments/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dodopayments
-  VERSION = "2.6.0"
+  VERSION = "2.7.0"
 end

data/lib/dodopayments.rb

@@ -186,6 +186,7 @@ require_relative "dodopayments/models/license_activate_params"
 require_relative "dodopayments/models/license_activate_response"
 require_relative "dodopayments/models/license_deactivate_params"
 require_relative "dodopayments/models/license_key_created_webhook_event"
+require_relative "dodopayments/models/license_key_create_params"
 require_relative "dodopayments/models/license_key_duration"
 require_relative "dodopayments/models/license_key_instance"
 require_relative "dodopayments/models/license_key_instance_list_params"