dodopayments 2.18.0 → 2.19.0

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

@@ -50,8 +50,8 @@ module Dodopayments
         # @!attribute metadata
         #   Arbitrary key-value metadata recorded on the grant.
         #
-        #   @return [Hash{Symbol=>String}]
-        required :metadata, Dodopayments::Internal::Type::HashOf[String]
+        #   @return [Hash{Symbol=>String, Float, Boolean}]
+        required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
         # @!attribute status
         #   Lifecycle status of the grant.
@@ -90,6 +90,13 @@ module Dodopayments
         #   @return [String, nil]
         optional :error_message, String, nil?: true
 
+        # @!attribute feature
+        #   Typed feature payload, present only when the entitlement integration is
+        #   `feature_flag`; `null` for every other integration type.
+        #
+        #   @return [Dodopayments::Models::Feature, nil]
+        optional :feature, -> { Dodopayments::Feature }, nil?: true
+
         # @!attribute license_key
         #   License-key delivery payload, present when the entitlement integration is
         #   `license_key`.
@@ -135,7 +142,7 @@ module Dodopayments
         #   @return [String, nil]
         optional :subscription_id, String, nil?: true
 
-        # @!method initialize(id:, brand_id:, business_id:, created_at:, customer_id:, entitlement_id:, integration_type:, metadata:, status:, updated_at:, delivered_at: nil, digital_product_delivery: nil, error_code: nil, error_message: nil, license_key: nil, oauth_expires_at: nil, oauth_url: nil, payment_id: nil, revocation_reason: nil, revoked_at: nil, subscription_id: nil)
+        # @!method initialize(id:, brand_id:, business_id:, created_at:, customer_id:, entitlement_id:, integration_type:, metadata:, status:, updated_at:, delivered_at: nil, digital_product_delivery: nil, error_code: nil, error_message: nil, feature: nil, license_key: nil, oauth_expires_at: nil, oauth_url: nil, payment_id: nil, revocation_reason: nil, revoked_at: nil, subscription_id: nil)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::Entitlements::EntitlementGrant} for more details.
         #
@@ -156,7 +163,7 @@ module Dodopayments
         #
         #   @param integration_type [Symbol, Dodopayments::Models::EntitlementIntegrationType] The integration type of the grant's entitlement (e.g. `license_key`).
         #
-        #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value metadata recorded on the grant.
+        #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Arbitrary key-value metadata recorded on the grant.
         #
         #   @param status [Symbol, Dodopayments::Models::Entitlements::EntitlementGrant::Status] Lifecycle status of the grant.
         #
@@ -170,6 +177,8 @@ module Dodopayments
         #
         #   @param error_message [String, nil] Human-readable message reported when delivery failed, when applicable.
         #
+        #   @param feature [Dodopayments::Models::Feature, nil] Typed feature payload, present only when the entitlement integration is
+        #
         #   @param license_key [Dodopayments::Models::Entitlements::LicenseKeyGrant, nil] License-key delivery payload, present when the entitlement integration
         #
         #   @param oauth_expires_at [Time, nil] Timestamp when `oauth_url` stops being valid, when applicable.

data/lib/dodopayments/models/feature.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    class Feature < Dodopayments::Internal::Type::BaseModel
+      # @!attribute feature_id
+      #   Identifier of the capability this grant confers.
+      #
+      #   @return [String]
+      required :feature_id, String
+
+      # @!attribute feature_type
+      #   Type of capability conferred.
+      #
+      #   @return [Symbol, Dodopayments::Models::FeatureType]
+      required :feature_type, enum: -> { Dodopayments::FeatureType }
+
+      # @!method initialize(feature_id:, feature_type:)
+      #   Capability conferred by a `feature_flag` grant.
+      #
+      #   @param feature_id [String] Identifier of the capability this grant confers.
+      #
+      #   @param feature_type [Symbol, Dodopayments::Models::FeatureType] Type of capability conferred.
+    end
+  end
+end

data/lib/dodopayments/models/feature_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # Type of capability a `feature_flag` entitlement confers.
+    module FeatureType
+      extend Dodopayments::Internal::Type::Enum
+
+      BOOLEAN = :boolean
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/dodopayments/models/integration_config.rb

@@ -4,9 +4,15 @@ module Dodopayments
   module Models
     # Integration-specific configuration supplied when creating or updating an
     # entitlement. The shape required matches the entitlement's `integration_type`.
+    #
+    # Untagged enum: variants are matched in order. `FeatureFlag` must precede
+    # `LicenseKey`, whose fields are all optional and would otherwise match a
+    # `feature_flag` config.
     module IntegrationConfig
       extend Dodopayments::Internal::Type::Union
 
+      variant -> { Dodopayments::IntegrationConfig::FeatureFlagConfig }
+
       variant -> { Dodopayments::IntegrationConfig::GitHubConfig }
 
       variant -> { Dodopayments::IntegrationConfig::DiscordConfig }
@@ -23,6 +29,29 @@ module Dodopayments
 
       variant -> { Dodopayments::IntegrationConfig::LicenseKeyConfig }
 
+      class FeatureFlagConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute feature_id
+        #   Merchant-chosen identifier for the capability this entitlement unlocks. Not
+        #   unique across entitlements.
+        #
+        #   @return [String]
+        required :feature_id, String
+
+        # @!attribute feature_type
+        #   Type of capability conferred.
+        #
+        #   @return [Symbol, Dodopayments::Models::FeatureType]
+        required :feature_type, enum: -> { Dodopayments::FeatureType }
+
+        # @!method initialize(feature_id:, feature_type:)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::IntegrationConfig::FeatureFlagConfig} for more details.
+        #
+        #   @param feature_id [String] Merchant-chosen identifier for the capability this entitlement
+        #
+        #   @param feature_type [Symbol, Dodopayments::Models::FeatureType] Type of capability conferred.
+      end
+
       class GitHubConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute permission
         #   Permission to grant on the repository.
@@ -222,7 +251,7 @@ module Dodopayments
       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)]
+      #   @return [Array(Dodopayments::Models::IntegrationConfig::FeatureFlagConfig, 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

@@ -9,6 +9,8 @@ module Dodopayments
     module IntegrationConfigResponse
       extend Dodopayments::Internal::Type::Union
 
+      variant -> { Dodopayments::IntegrationConfigResponse::FeatureFlagConfig }
+
       variant -> { Dodopayments::IntegrationConfigResponse::GitHubConfig }
 
       variant -> { Dodopayments::IntegrationConfigResponse::DiscordConfig }
@@ -25,6 +27,25 @@ module Dodopayments
 
       variant -> { Dodopayments::IntegrationConfigResponse::LicenseKeyConfig }
 
+      class FeatureFlagConfig < Dodopayments::Internal::Type::BaseModel
+        # @!attribute feature_id
+        #   Merchant-chosen identifier for the capability this entitlement unlocks.
+        #
+        #   @return [String]
+        required :feature_id, String
+
+        # @!attribute feature_type
+        #   Type of capability conferred. Only `boolean` is supported today.
+        #
+        #   @return [Symbol, Dodopayments::Models::FeatureType]
+        required :feature_type, enum: -> { Dodopayments::FeatureType }
+
+        # @!method initialize(feature_id:, feature_type:)
+        #   @param feature_id [String] Merchant-chosen identifier for the capability this entitlement unlocks.
+        #
+        #   @param feature_type [Symbol, Dodopayments::Models::FeatureType] Type of capability conferred. Only `boolean` is supported today.
+      end
+
       class GitHubConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute permission
         #   Permission to grant on the repository.
@@ -283,7 +304,7 @@ module Dodopayments
       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)]
+      #   @return [Array(Dodopayments::Models::IntegrationConfigResponse::FeatureFlagConfig, 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_duration.rb

@@ -9,13 +9,15 @@ module Dodopayments
       required :count, Integer
 
       # @!attribute interval
+      #   Unit of a duration count (e.g. license-key validity period).
       #
       #   @return [Symbol, Dodopayments::Models::TimeInterval]
       required :interval, enum: -> { Dodopayments::TimeInterval }
 
       # @!method initialize(count:, interval:)
       #   @param count [Integer]
-      #   @param interval [Symbol, Dodopayments::Models::TimeInterval]
+      #
+      #   @param interval [Symbol, Dodopayments::Models::TimeInterval] Unit of a duration count (e.g. license-key validity period).
     end
   end
 end

data/lib/dodopayments/models/metadata.rb

@@ -2,7 +2,21 @@
 
 module Dodopayments
   module Models
+    # Metadata value can be a string, integer, number, or boolean
+    module MetadataItem
+      extend Dodopayments::Internal::Type::Union
+
+      variant String
+
+      variant Float
+
+      variant Dodopayments::Internal::Type::Boolean
+
+      # @!method self.variants
+      #   @return [Array(String, Float, Boolean)]
+    end
+
     # @type [Dodopayments::Internal::Type::Converter]
-    Metadata = Dodopayments::Internal::Type::HashOf[String]
+    Metadata = Dodopayments::Internal::Type::HashOf[union: -> { Dodopayments::MetadataItem }]
   end
 end

data/lib/dodopayments/models/payment.rb

@@ -41,7 +41,7 @@ module Dodopayments
       required :customer, -> { Dodopayments::CustomerLimitedDetails }
 
       # @!attribute digital_products_delivered
-      #   brand id this payment belongs to
+      #   Whether the digital products purchased in this payment have been delivered.
       #
       #   @return [Boolean]
       required :digital_products_delivered, Dodopayments::Internal::Type::Boolean
@@ -55,8 +55,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional custom data associated with the payment
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute payment_id
       #   Unique identifier for the payment
@@ -276,11 +276,11 @@ module Dodopayments
       #
       #   @param customer [Dodopayments::Models::CustomerLimitedDetails] Details about the customer who made the payment
       #
-      #   @param digital_products_delivered [Boolean] brand id this payment belongs to
+      #   @param digital_products_delivered [Boolean] Whether the digital products purchased in this payment have been delivered.
       #
       #   @param disputes [Array<Dodopayments::Models::Dispute>] List of disputes associated with this payment
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional custom data associated with the payment
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the payment
       #
       #   @param payment_id [String] Unique identifier for the payment
       #

data/lib/dodopayments/models/payment_create_params.rb

@@ -86,8 +86,8 @@ module Dodopayments
       #   Additional metadata associated with the payment. Defaults to empty if not
       #   provided.
       #
-      #   @return [Hash{Symbol=>String}, nil]
-      optional :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute payment_link
       #   Whether to generate a payment link. Defaults to false if not specified.
@@ -168,7 +168,7 @@ module Dodopayments
       #
       #   @param force_3ds [Boolean, nil] Override merchant default 3DS behaviour for this payment
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata associated with the payment.
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata associated with the payment.
       #
       #   @param payment_link [Boolean, nil] Whether to generate a payment link. Defaults to false if not specified.
       #

data/lib/dodopayments/models/payment_create_response.rb

@@ -20,8 +20,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata associated with the payment
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute payment_id
       #   Unique identifier for the payment
@@ -79,7 +79,7 @@ module Dodopayments
       #
       #   @param customer [Dodopayments::Models::CustomerLimitedDetails] Limited details about the customer making the payment
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata associated with the payment
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata associated with the payment
       #
       #   @param payment_id [String] Unique identifier for the payment
       #

data/lib/dodopayments/models/payment_list_response.rb

@@ -35,9 +35,10 @@ module Dodopayments
       required :has_license_key, Dodopayments::Internal::Type::Boolean
 
       # @!attribute metadata
+      #   Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute payment_id
       #
@@ -129,7 +130,7 @@ module Dodopayments
       #
       #   @param has_license_key [Boolean]
       #
-      #   @param metadata [Hash{Symbol=>String}]
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
       #
       #   @param payment_id [String]
       #

data/lib/dodopayments/models/product.rb

@@ -52,8 +52,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional custom data associated with the product
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute price
       #   Pricing information for the product.
@@ -163,7 +163,7 @@ module Dodopayments
       #
       #   @param license_key_enabled [Boolean] Indicates whether the product requires a license key.
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional custom data associated with the product
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the product
       #
       #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice] Pricing information for the product.
       #

data/lib/dodopayments/models/product_create_params.rb

@@ -117,8 +117,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the product
       #
-      #   @return [Hash{Symbol=>String}, nil]
-      optional :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute pricing_mode
       #   Pricing mode for localized pricing. When set, rules from
@@ -158,7 +158,7 @@ module Dodopayments
       #
       #   @param license_key_enabled [Boolean, nil] When true, generates and sends a license key to your customer.
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata for the product
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata for the product
       #
       #   @param pricing_mode [Symbol, Dodopayments::Models::Products::PricingMode, nil] Pricing mode for localized pricing. When set, rules from
       #

data/lib/dodopayments/models/product_entitlement_summary.rb

@@ -14,7 +14,7 @@ module Dodopayments
       #   For `digital_files` entitlements the response includes presigned download URLs
       #   for each attached file; other integrations match the shape supplied at creation.
       #
-      #   @return [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]
+      #   @return [Dodopayments::Models::IntegrationConfigResponse::FeatureFlagConfig, 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]
       required :integration_config, union: -> { Dodopayments::IntegrationConfigResponse }
 
       # @!attribute integration_type
@@ -45,7 +45,7 @@ module Dodopayments
       #
       #   @param id [String]
       #
-      #   @param integration_config [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] Integration-specific configuration on an entitlement read response.
+      #   @param integration_config [Dodopayments::Models::IntegrationConfigResponse::FeatureFlagConfig, 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] Integration-specific configuration on an entitlement read response.
       #
       #   @param integration_type [Symbol, Dodopayments::Models::EntitlementIntegrationType]
       #

data/lib/dodopayments/models/product_list_response.rb

@@ -32,8 +32,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional custom data associated with the product
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute product_id
       #   Unique identifier for the product.
@@ -123,7 +123,7 @@ module Dodopayments
       #
       #   @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
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the product
       #
       #   @param product_id [String] Unique identifier for the product.
       #

data/lib/dodopayments/models/product_update_params.rb

@@ -116,8 +116,10 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the product
       #
-      #   @return [Hash{Symbol=>String}, nil]
-      optional :metadata, Dodopayments::Internal::Type::HashOf[String], nil?: true
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata,
+               -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] },
+               nil?: true
 
       # @!attribute name
       #   Name of the product, optional and must be at most 100 characters.
@@ -173,7 +175,7 @@ module Dodopayments
       #
       #   @param license_key_enabled [Boolean, nil] Whether the product requires a license key.
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Additional metadata for the product
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Additional metadata for the product
       #
       #   @param name [String, nil] Name of the product, optional and must be at most 100 characters.
       #

data/lib/dodopayments/models/refund.rb

@@ -37,8 +37,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata stored with the refund.
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute payment_id
       #   The unique identifier of the payment associated with the refund.
@@ -87,7 +87,7 @@ module Dodopayments
       #
       #   @param is_partial [Boolean] If true the refund is a partial refund
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata stored with the refund.
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata stored with the refund.
       #
       #   @param payment_id [String] The unique identifier of the payment associated with the refund.
       #

data/lib/dodopayments/models/refund_create_params.rb

@@ -24,8 +24,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata associated with the refund.
       #
-      #   @return [Hash{Symbol=>String}, nil]
-      optional :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute reason
       #   The reason for the refund, if any. Maximum length is 3000 characters. Optional.
@@ -38,7 +38,7 @@ module Dodopayments
       #
       #   @param items [Array<Dodopayments::Models::RefundCreateParams::Item>, nil] Partially Refund an Individual Item
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata associated with the refund.
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata associated with the refund.
       #
       #   @param reason [String, nil] The reason for the refund, if any. Maximum length is 3000 characters. Optional.
       #

data/lib/dodopayments/models/subscription.rb

@@ -56,8 +56,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional custom data associated with the subscription
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute meter_credit_entitlement_cart
       #   Meter credit entitlement cart settings for this subscription
@@ -257,7 +257,7 @@ module Dodopayments
       #
       #   @param customer [Dodopayments::Models::CustomerLimitedDetails] Customer details associated with the subscription
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional custom data associated with the subscription
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the subscription
       #
       #   @param meter_credit_entitlement_cart [Array<Dodopayments::Models::MeterCreditEntitlementCartResponse>] Meter credit entitlement cart settings for this subscription
       #

data/lib/dodopayments/models/subscription_charge_params.rb

@@ -39,8 +39,10 @@ module Dodopayments
       #   Metadata for the payment. If not passed, the metadata of the subscription will
       #   be taken
       #
-      #   @return [Hash{Symbol=>String}, nil]
-      optional :metadata, Dodopayments::Internal::Type::HashOf[String], nil?: true
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata,
+               -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] },
+               nil?: true
 
       # @!attribute product_currency
       #   Optional currency of the product price. If not specified, defaults to the
@@ -68,7 +70,7 @@ module Dodopayments
       #
       #   @param customer_balance_config [Dodopayments::Models::SubscriptionChargeParams::CustomerBalanceConfig, nil] Specify how customer balance is used for the payment
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Metadata for the payment. If not passed, the metadata of the subscription will b
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Metadata for the payment. If not passed, the metadata of the subscription will b
       #
       #   @param product_currency [Symbol, Dodopayments::Models::Currency, nil] Optional currency of the product price. If not specified, defaults to the curren
       #

data/lib/dodopayments/models/subscription_create_params.rb

@@ -101,8 +101,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the subscription Defaults to empty if not specified
       #
-      #   @return [Hash{Symbol=>String}, nil]
-      optional :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute on_demand
       #
@@ -207,7 +207,7 @@ module Dodopayments
       #
       #   @param mandate_min_amount_inr_paise [Integer, nil] Override the merchant-level mandate floor (in INR paise) for INR
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata for the subscription
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata for the subscription
       #
       #   @param on_demand [Dodopayments::Models::OnDemandSubscription, nil]
       #

data/lib/dodopayments/models/subscription_create_response.rb

@@ -19,8 +19,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata associated with the subscription
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute payment_id
       #   First payment id for the subscription
@@ -91,7 +91,7 @@ module Dodopayments
       #
       #   @param customer [Dodopayments::Models::CustomerLimitedDetails] Customer details associated with this subscription
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata associated with the subscription
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata associated with the subscription
       #
       #   @param payment_id [String] First payment id for the subscription
       #

data/lib/dodopayments/models/subscription_list_response.rb

@@ -44,8 +44,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional custom data associated with the subscription
       #
-      #   @return [Hash{Symbol=>String}]
-      required :metadata, Dodopayments::Internal::Type::HashOf[String]
+      #   @return [Hash{Symbol=>String, Float, Boolean}]
+      required :metadata, -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] }
 
       # @!attribute next_billing_date
       #   Timestamp of the next scheduled billing. Indicates the end of current billing
@@ -200,7 +200,7 @@ module Dodopayments
       #
       #   @param discounts [Array<Dodopayments::Models::SubscriptionListResponse::Discount>] All stacked discounts applied, in order of application
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional custom data associated with the subscription
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the subscription
       #
       #   @param next_billing_date [Time] Timestamp of the next scheduled billing. Indicates the end of current billing pe
       #

data/lib/dodopayments/models/subscription_update_params.rb

@@ -72,9 +72,12 @@ module Dodopayments
       optional :disable_on_demand, -> { Dodopayments::SubscriptionUpdateParams::DisableOnDemand }, nil?: true
 
       # @!attribute metadata
+      #   Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
       #
-      #   @return [Hash{Symbol=>String}, nil]
-      optional :metadata, Dodopayments::Internal::Type::HashOf[String], nil?: true
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata,
+               -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] },
+               nil?: true
 
       # @!attribute next_billing_date
       #
@@ -115,7 +118,7 @@ module Dodopayments
       #
       #   @param disable_on_demand [Dodopayments::Models::SubscriptionUpdateParams::DisableOnDemand, nil]
       #
-      #   @param metadata [Hash{Symbol=>String}, nil]
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
       #
       #   @param next_billing_date [Time, nil]
       #
@@ -189,22 +192,33 @@ module Dodopayments
         optional :rollover_timeframe_count, Integer, nil?: true
 
         # @!attribute rollover_timeframe_interval
+        #   Unit of a duration count (e.g. license-key validity period).
         #
         #   @return [Symbol, Dodopayments::Models::TimeInterval, nil]
         optional :rollover_timeframe_interval, enum: -> { Dodopayments::TimeInterval }, nil?: true
 
         # @!method initialize(credit_entitlement_id:, credits_amount: nil, expires_after_days: nil, low_balance_threshold_percent: nil, max_rollover_count: nil, overage_enabled: nil, overage_limit: nil, rollover_enabled: nil, rollover_percentage: nil, rollover_timeframe_count: nil, rollover_timeframe_interval: nil)
         #   @param credit_entitlement_id [String]
+        #
         #   @param credits_amount [String, nil]
+        #
         #   @param expires_after_days [Integer, nil]
+        #
         #   @param low_balance_threshold_percent [Integer, nil]
+        #
         #   @param max_rollover_count [Integer, nil]
+        #
         #   @param overage_enabled [Boolean, nil]
+        #
         #   @param overage_limit [String, nil]
+        #
         #   @param rollover_enabled [Boolean, nil]
+        #
         #   @param rollover_percentage [Integer, nil]
+        #
         #   @param rollover_timeframe_count [Integer, nil]
-        #   @param rollover_timeframe_interval [Symbol, Dodopayments::Models::TimeInterval, nil]
+        #
+        #   @param rollover_timeframe_interval [Symbol, Dodopayments::Models::TimeInterval, nil] Unit of a duration count (e.g. license-key validity period).
       end
 
       class DisableOnDemand < Dodopayments::Internal::Type::BaseModel