dodopayments 2.18.1 → 2.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53e205dc9f7e8ee7ebdaeb422170dbc186e5a6f7e06d1c3cfb535351c9aded9b
-  data.tar.gz: 889f3b95deae7e7e27703e2792a42c7eacca334b62f077aaea57882b5d26efc8
+  metadata.gz: 0a1c544a4176c7c0714185ca6adf9c37fb36def28490b0ab142787bc2b3adf84
+  data.tar.gz: 526d3979f72eb82772a3fdc05d77a8a083a720dc38346e492829e6343491df90
 SHA512:
-  metadata.gz: 9921852a50435bbccfead823afd4b085c8872a4c1b52fec15f7956a9dfe216faea6d93ad7f054dcf24339d062f2fad55f91cb4464f13470782c47288fa011187
-  data.tar.gz: 7376387a8df94f986e4e8a0fdcef6df3ce6f0b4b5048e30cddb4758e3414aaecdb538765bcae277086a143fdff466a37740cc42925792816add2c23f6f201f8f
+  metadata.gz: fa2892ef06e81edaf152d83e460f117ba34c634984f4321240806f531f2a4f48bcea530b0478961afaa7b6c5e0ff0fe4da306abf55307350ae720cf280d700a2
+  data.tar.gz: e2523d71b90539c1919ea64fb6699e90e324bfdeef17567851a8d1e0fab41783f18095ecec460d02fde838c599f62ae6f633190b40e78a8a2bd819d1e3665b42

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.19.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.18.1...v2.19.0) (2026-07-04)
+
+
+### Features
+
+* **api:** register Feature/FeatureType models and expose customer entitlement-grants list endpoint ([e0a2559](https://github.com/dodopayments/dodopayments-ruby/commit/e0a2559136a4c577fd58c08445a6d54e5aa5036c))
+* **api:** register Feature/FeatureType models and expose customer entitlement-grants list endpoint ([b4e6b71](https://github.com/dodopayments/dodopayments-ruby/commit/b4e6b7103d93dd44e282a3143a235f4ddc0b6068))
+
 ## [2.18.1](https://github.com/dodopayments/dodopayments-ruby/compare/v2.18.0...v2.18.1) (2026-06-27)
 
 

data/README.md

@@ -23,7 +23,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "dodopayments", "~> 2.18.1"
+gem "dodopayments", "~> 2.19.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/models/checkout_session_request.rb

@@ -117,8 +117,10 @@ 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], nil?: true
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :metadata,
+               -> { Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem] },
+               nil?: true
 
       # @!attribute minimal_address
       #   If true, only zipcode is required when confirm is true; other address fields
@@ -204,7 +206,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}, nil] Additional metadata associated with the payment. Defaults to empty if not provid
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Additional metadata associated with the payment. Defaults to empty if not provid
       #
       #   @param minimal_address [Boolean] If true, only zipcode is required when confirm is true; other address fields rem
       #

data/lib/dodopayments/models/credit_entitlements/balance_create_ledger_entry_params.rb

@@ -46,8 +46,10 @@ module Dodopayments
         #   Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500
         #   chars)
         #
-        #   @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 reason
         #   Human-readable reason for the entry
@@ -72,7 +74,7 @@ module Dodopayments
         #
         #   @param idempotency_key [String, nil] Idempotency key to prevent duplicate entries
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500 chars
+        #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500 chars
         #
         #   @param reason [String, nil] Human-readable reason for the entry
         #

data/lib/dodopayments/models/credit_entitlements/balance_list_grants_response.rb

@@ -67,9 +67,12 @@ module Dodopayments
         optional :expires_at, Time, 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 parent_grant_id
         #
@@ -82,22 +85,40 @@ module Dodopayments
         optional :source_id, String, nil?: true
 
         # @!method initialize(id:, created_at:, credit_entitlement_id:, customer_id:, initial_amount:, is_expired:, is_rolled_over:, remaining_amount:, rollover_count:, source_type:, updated_at:, expires_at: nil, metadata: nil, parent_grant_id: nil, source_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::CreditEntitlements::BalanceListGrantsResponse} for more
+        #   details.
+        #
         #   Response for a credit grant
         #
         #   @param id [String]
+        #
         #   @param created_at [Time]
+        #
         #   @param credit_entitlement_id [String]
+        #
         #   @param customer_id [String]
+        #
         #   @param initial_amount [String]
+        #
         #   @param is_expired [Boolean]
+        #
         #   @param is_rolled_over [Boolean]
+        #
         #   @param remaining_amount [String]
+        #
         #   @param rollover_count [Integer]
+        #
         #   @param source_type [Symbol, Dodopayments::Models::CreditEntitlements::BalanceListGrantsResponse::SourceType]
+        #
         #   @param updated_at [Time]
+        #
         #   @param expires_at [Time, 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 parent_grant_id [String, nil]
+        #
         #   @param source_id [String, nil]
 
         # @see Dodopayments::Models::CreditEntitlements::BalanceListGrantsResponse#source_type

data/lib/dodopayments/models/credit_entitlements/credit_ledger_entry.rb

@@ -61,8 +61,8 @@ module Dodopayments
         #   created at checkout). Empty when the grant has no resolvable source (e.g.
         #   credits granted directly via the API).
         #
-        #   @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 overage_after
         #
@@ -126,7 +126,7 @@ module Dodopayments
         #
         #   @param is_credit [Boolean]
         #
-        #   @param metadata [Hash{Symbol=>String}] Metadata associated with the credit grant's source (the subscription or
+        #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Metadata associated with the credit grant's source (the subscription or
         #
         #   @param overage_after [String]
         #

data/lib/dodopayments/models/customer.rb

@@ -32,8 +32,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the customer
       #
-      #   @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 phone_number
       #
@@ -51,7 +51,7 @@ module Dodopayments
       #
       #   @param name [String]
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata for the customer
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata for the customer
       #
       #   @param phone_number [String, nil]
     end

data/lib/dodopayments/models/customer_create_params.rb

@@ -20,8 +20,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the customer
       #
-      #   @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 phone_number
       #
@@ -33,7 +33,7 @@ module Dodopayments
       #
       #   @param name [String]
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata for the customer
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata for the customer
       #
       #   @param phone_number [String, nil]
       #

data/lib/dodopayments/models/customer_limited_details.rb

@@ -24,8 +24,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata associated with the customer
       #
-      #   @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 phone_number
       #   Phone number of the customer
@@ -40,7 +40,7 @@ module Dodopayments
       #
       #   @param name [String] Full name of the customer
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata associated with the customer
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata associated with the customer
       #
       #   @param phone_number [String, nil] Phone number of the customer
     end

data/lib/dodopayments/models/customer_list_entitlement_grants_params.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Customers#list_entitlement_grants
+    class CustomerListEntitlementGrantsParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute customer_id
+      #
+      #   @return [String]
+      required :customer_id, String
+
+      # @!attribute integration_type
+      #   Filter by integration type (e.g. `feature_flag`)
+      #
+      #   @return [Symbol, Dodopayments::Models::CustomerListEntitlementGrantsParams::IntegrationType, nil]
+      optional :integration_type,
+               enum: -> { Dodopayments::CustomerListEntitlementGrantsParams::IntegrationType }
+
+      # @!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::CustomerListEntitlementGrantsParams::Status, nil]
+      optional :status, enum: -> { Dodopayments::CustomerListEntitlementGrantsParams::Status }
+
+      # @!method initialize(customer_id:, integration_type: nil, page_number: nil, page_size: nil, status: nil, request_options: {})
+      #   @param customer_id [String]
+      #
+      #   @param integration_type [Symbol, Dodopayments::Models::CustomerListEntitlementGrantsParams::IntegrationType] Filter by integration type (e.g. `feature_flag`)
+      #
+      #   @param page_number [Integer] Page number (default 0)
+      #
+      #   @param page_size [Integer] Page size (default 10, max 100)
+      #
+      #   @param status [Symbol, Dodopayments::Models::CustomerListEntitlementGrantsParams::Status] Filter by grant status
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by integration type (e.g. `feature_flag`)
+      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
+        FEATURE_FLAG = :feature_flag
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # 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

data/lib/dodopayments/models/customer_update_params.rb

@@ -20,8 +20,10 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the customer
       #
-      #   @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
       #
@@ -38,7 +40,7 @@ module Dodopayments
       #
       #   @param email [String, nil]
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Additional metadata for the customer
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Additional metadata for the customer
       #
       #   @param name [String, nil]
       #

data/lib/dodopayments/models/discount.rb

@@ -35,9 +35,10 @@ module Dodopayments
       required :discount_id, String
 
       # @!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 preserve_on_plan_change
       #   Whether this discount should be preserved when a subscription changes plans.
@@ -104,7 +105,7 @@ module Dodopayments
       #
       #   @param discount_id [String] The unique discount ID
       #
-      #   @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 preserve_on_plan_change [Boolean] Whether this discount should be preserved when a subscription changes plans.
       #

data/lib/dodopayments/models/discount_create_params.rb

@@ -40,8 +40,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the discount
       #
-      #   @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 name
       #
@@ -87,7 +87,7 @@ module Dodopayments
       #
       #   @param expires_at [Time, nil] When the discount expires, if ever.
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata for the discount
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata for the discount
       #
       #   @param name [String, nil]
       #

data/lib/dodopayments/models/discount_detail.rb

@@ -36,8 +36,8 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata
       #
-      #   @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 position
       #   Position of this discount in the stack (0-based)
@@ -117,7 +117,7 @@ module Dodopayments
       #
       #   @param discount_id [String] The unique discount ID
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata
       #
       #   @param position [Integer] Position of this discount in the stack (0-based)
       #

data/lib/dodopayments/models/discount_update_params.rb

@@ -35,8 +35,10 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the discount
       #
-      #   @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
       #
@@ -88,7 +90,7 @@ module Dodopayments
       #
       #   @param expires_at [Time, nil]
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Additional metadata for the discount
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Additional metadata for the discount
       #
       #   @param name [String, nil]
       #

data/lib/dodopayments/models/entitlement.rb

@@ -26,7 +26,7 @@ module Dodopayments
       #   Integration-specific configuration. For `digital_files` entitlements this
       #   includes presigned download URLs for each attached file.
       #
-      #   @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,8 +45,8 @@ module Dodopayments
       # @!attribute metadata
       #   Arbitrary key-value metadata supplied at creation or via PATCH.
       #
-      #   @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 name
       #   Display name supplied at creation.
@@ -79,13 +79,13 @@ module Dodopayments
       #
       #   @param created_at [Time] Timestamp when the entitlement was created.
       #
-      #   @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. For `digital_files` entitlements
+      #   @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. For `digital_files` entitlements
       #
       #   @param integration_type [Symbol, Dodopayments::Models::EntitlementIntegrationType] Platform integration this entitlement uses.
       #
       #   @param is_active [Boolean] Always `true` for entitlements returned by the public API;
       #
-      #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value metadata supplied at creation or via PATCH.
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Arbitrary key-value metadata supplied at creation or via PATCH.
       #
       #   @param name [String] Display name supplied at creation.
       #

data/lib/dodopayments/models/entitlement_create_params.rb

@@ -10,7 +10,7 @@ module Dodopayments
       # @!attribute integration_config
       #   Platform-specific configuration (validated per integration_type)
       #
-      #   @return [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 [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]
       required :integration_config, union: -> { Dodopayments::IntegrationConfig }
 
       # @!attribute integration_type
@@ -34,11 +34,11 @@ module Dodopayments
       # @!attribute metadata
       #   Additional metadata for the entitlement
       #
-      #   @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] }
 
       # @!method initialize(integration_config:, integration_type:, name:, description: nil, metadata: nil, request_options: {})
-      #   @param integration_config [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] Platform-specific configuration (validated per integration_type)
+      #   @param integration_config [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] Platform-specific configuration (validated per integration_type)
       #
       #   @param integration_type [Symbol, Dodopayments::Models::EntitlementIntegrationType] Which platform integration this entitlement uses
       #
@@ -46,7 +46,7 @@ module Dodopayments
       #
       #   @param description [String, nil] Optional description
       #
-      #   @param metadata [Hash{Symbol=>String}] Additional metadata for the entitlement
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata for the entitlement
       #
       #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/dodopayments/models/entitlement_integration_type.rb

@@ -13,6 +13,7 @@ module Dodopayments
       NOTION = :notion
       DIGITAL_FILES = :digital_files
       LICENSE_KEY = :license_key
+      FEATURE_FLAG = :feature_flag
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/dodopayments/models/entitlement_list_params.rb

@@ -46,6 +46,7 @@ module Dodopayments
         NOTION = :notion
         DIGITAL_FILES = :digital_files
         LICENSE_KEY = :license_key
+        FEATURE_FLAG = :feature_flag
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/dodopayments/models/entitlement_update_params.rb

@@ -21,13 +21,20 @@ module Dodopayments
       #   Integration-specific configuration supplied when creating or updating an
       #   entitlement. The shape required matches the entitlement's `integration_type`.
       #
-      #   @return [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, nil]
+      #   Untagged enum: variants are matched in order. `FeatureFlag` must precede
+      #   `LicenseKey`, whose fields are all optional and would otherwise match a
+      #   `feature_flag` config.
+      #
+      #   @return [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, nil]
       optional :integration_config, union: -> { Dodopayments::IntegrationConfig }, 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 name
       #
@@ -42,9 +49,9 @@ module Dodopayments
       #
       #   @param description [String, nil]
       #
-      #   @param integration_config [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, nil] Integration-specific configuration supplied when creating or updating
+      #   @param integration_config [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, nil] Integration-specific configuration supplied when creating or updating
       #
-      #   @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 name [String, nil]
       #

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