dodopayments 2.8.1 → 2.9.0

data/rbi/dodopayments/models/digital_product_delivery.rbi

@@ -11,46 +11,34 @@ module Dodopayments
           )
         end
 
-      # External URL to digital product
+      sig { returns(T::Array[Dodopayments::DigitalProductDeliveryFile]) }
+      attr_accessor :files
+
       sig { returns(T.nilable(String)) }
       attr_accessor :external_url
 
-      # Uploaded files ids of digital product
-      sig do
-        returns(T.nilable(T::Array[Dodopayments::DigitalProductDeliveryFile]))
-      end
-      attr_accessor :files
-
-      # Instructions to download and use the digital product
       sig { returns(T.nilable(String)) }
       attr_accessor :instructions
 
+      # Digital-product-delivery payload for a grant. Populated for grants whose
+      # entitlement has `integration_type = 'digital_files'`. `files` carries presigned
+      # download URLs; the source (EE service or legacy in-process S3 presigning) is
+      # opaque to the caller.
       sig do
         params(
+          files: T::Array[Dodopayments::DigitalProductDeliveryFile::OrHash],
           external_url: T.nilable(String),
-          files:
-            T.nilable(
-              T::Array[Dodopayments::DigitalProductDeliveryFile::OrHash]
-            ),
           instructions: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(
-        # External URL to digital product
-        external_url: nil,
-        # Uploaded files ids of digital product
-        files: nil,
-        # Instructions to download and use the digital product
-        instructions: nil
-      )
+      def self.new(files:, external_url: nil, instructions: nil)
       end
 
       sig do
         override.returns(
           {
+            files: T::Array[Dodopayments::DigitalProductDeliveryFile],
             external_url: T.nilable(String),
-            files:
-              T.nilable(T::Array[Dodopayments::DigitalProductDeliveryFile]),
             instructions: T.nilable(String)
           }
         )

data/rbi/dodopayments/models/digital_product_delivery_file.rbi

@@ -12,24 +12,56 @@ module Dodopayments
         end
 
       sig { returns(String) }
-      attr_accessor :file_id
+      attr_accessor :download_url
+
+      # Seconds until `download_url` expires.
+      sig { returns(Integer) }
+      attr_accessor :expires_in
 
       sig { returns(String) }
-      attr_accessor :file_name
+      attr_accessor :file_id
 
       sig { returns(String) }
-      attr_accessor :url
+      attr_accessor :filename
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :content_type
+
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :file_size
 
       sig do
-        params(file_id: String, file_name: String, url: String).returns(
-          T.attached_class
-        )
+        params(
+          download_url: String,
+          expires_in: Integer,
+          file_id: String,
+          filename: String,
+          content_type: T.nilable(String),
+          file_size: T.nilable(Integer)
+        ).returns(T.attached_class)
       end
-      def self.new(file_id:, file_name:, url:)
+      def self.new(
+        download_url:,
+        # Seconds until `download_url` expires.
+        expires_in:,
+        file_id:,
+        filename:,
+        content_type: nil,
+        file_size: nil
+      )
       end
 
       sig do
-        override.returns({ file_id: String, file_name: String, url: String })
+        override.returns(
+          {
+            download_url: String,
+            expires_in: Integer,
+            file_id: String,
+            filename: String,
+            content_type: T.nilable(String),
+            file_size: T.nilable(Integer)
+          }
+        )
       end
       def to_hash
       end

data/rbi/dodopayments/models/entitlement.rbi

@@ -0,0 +1,112 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class Entitlement < Dodopayments::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Dodopayments::Entitlement, Dodopayments::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(String) }
+      attr_accessor :business_id
+
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      # Public-facing variant of [`IntegrationConfig`]. Mirrors every variant shape on
+      # the wire EXCEPT `DigitalFiles`, which is replaced with a hydrated
+      # `digital_files` object (resolved download URLs etc.). The persisted JSONB stays
+      # ID-only via [`IntegrationConfig`]; this enum is response-only.
+      sig { returns(Dodopayments::IntegrationConfigResponse::Variants) }
+      attr_accessor :integration_config
+
+      sig { returns(Dodopayments::EntitlementIntegrationType::TaggedSymbol) }
+      attr_accessor :integration_type
+
+      sig { returns(T::Boolean) }
+      attr_accessor :is_active
+
+      sig { returns(String) }
+      attr_accessor :name
+
+      sig { returns(Time) }
+      attr_accessor :updated_at
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :description
+
+      sig { returns(T.nilable(T.anything)) }
+      attr_reader :metadata
+
+      sig { params(metadata: T.anything).void }
+      attr_writer :metadata
+
+      sig do
+        params(
+          id: String,
+          business_id: String,
+          created_at: Time,
+          integration_config:
+            T.any(
+              Dodopayments::IntegrationConfigResponse::GitHubConfig::OrHash,
+              Dodopayments::IntegrationConfigResponse::DiscordConfig::OrHash,
+              Dodopayments::IntegrationConfigResponse::TelegramConfig::OrHash,
+              Dodopayments::IntegrationConfigResponse::FigmaConfig::OrHash,
+              Dodopayments::IntegrationConfigResponse::FramerConfig::OrHash,
+              Dodopayments::IntegrationConfigResponse::NotionConfig::OrHash,
+              Dodopayments::IntegrationConfigResponse::DigitalFilesConfig::OrHash,
+              Dodopayments::IntegrationConfigResponse::LicenseKeyConfig::OrHash
+            ),
+          integration_type: Dodopayments::EntitlementIntegrationType::OrSymbol,
+          is_active: T::Boolean,
+          name: String,
+          updated_at: Time,
+          description: T.nilable(String),
+          metadata: T.anything
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        business_id:,
+        created_at:,
+        # Public-facing variant of [`IntegrationConfig`]. Mirrors every variant shape on
+        # the wire EXCEPT `DigitalFiles`, which is replaced with a hydrated
+        # `digital_files` object (resolved download URLs etc.). The persisted JSONB stays
+        # ID-only via [`IntegrationConfig`]; this enum is response-only.
+        integration_config:,
+        integration_type:,
+        is_active:,
+        name:,
+        updated_at:,
+        description: nil,
+        metadata: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            business_id: String,
+            created_at: Time,
+            integration_config:
+              Dodopayments::IntegrationConfigResponse::Variants,
+            integration_type:
+              Dodopayments::EntitlementIntegrationType::TaggedSymbol,
+            is_active: T::Boolean,
+            name: String,
+            updated_at: Time,
+            description: T.nilable(String),
+            metadata: T.anything
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/entitlement_create_params.rbi

@@ -0,0 +1,112 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class EntitlementCreateParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::EntitlementCreateParams,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      # Platform-specific configuration (validated per integration_type)
+      sig do
+        returns(
+          T.any(
+            Dodopayments::IntegrationConfig::GitHubConfig,
+            Dodopayments::IntegrationConfig::DiscordConfig,
+            Dodopayments::IntegrationConfig::TelegramConfig,
+            Dodopayments::IntegrationConfig::FigmaConfig,
+            Dodopayments::IntegrationConfig::FramerConfig,
+            Dodopayments::IntegrationConfig::NotionConfig,
+            Dodopayments::IntegrationConfig::DigitalFilesConfig,
+            Dodopayments::IntegrationConfig::LicenseKeyConfig
+          )
+        )
+      end
+      attr_accessor :integration_config
+
+      # Which platform integration this entitlement uses
+      sig { returns(Dodopayments::EntitlementIntegrationType::OrSymbol) }
+      attr_accessor :integration_type
+
+      # Display name for this entitlement
+      sig { returns(String) }
+      attr_accessor :name
+
+      # Optional description
+      sig { returns(T.nilable(String)) }
+      attr_accessor :description
+
+      # Optional user-facing metadata
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_accessor :metadata
+
+      sig do
+        params(
+          integration_config:
+            T.any(
+              Dodopayments::IntegrationConfig::GitHubConfig::OrHash,
+              Dodopayments::IntegrationConfig::DiscordConfig::OrHash,
+              Dodopayments::IntegrationConfig::TelegramConfig::OrHash,
+              Dodopayments::IntegrationConfig::FigmaConfig::OrHash,
+              Dodopayments::IntegrationConfig::FramerConfig::OrHash,
+              Dodopayments::IntegrationConfig::NotionConfig::OrHash,
+              Dodopayments::IntegrationConfig::DigitalFilesConfig::OrHash,
+              Dodopayments::IntegrationConfig::LicenseKeyConfig::OrHash
+            ),
+          integration_type: Dodopayments::EntitlementIntegrationType::OrSymbol,
+          name: String,
+          description: T.nilable(String),
+          metadata: T.nilable(T::Hash[Symbol, String]),
+          request_options: Dodopayments::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Platform-specific configuration (validated per integration_type)
+        integration_config:,
+        # Which platform integration this entitlement uses
+        integration_type:,
+        # Display name for this entitlement
+        name:,
+        # Optional description
+        description: nil,
+        # Optional user-facing metadata
+        metadata: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            integration_config:
+              T.any(
+                Dodopayments::IntegrationConfig::GitHubConfig,
+                Dodopayments::IntegrationConfig::DiscordConfig,
+                Dodopayments::IntegrationConfig::TelegramConfig,
+                Dodopayments::IntegrationConfig::FigmaConfig,
+                Dodopayments::IntegrationConfig::FramerConfig,
+                Dodopayments::IntegrationConfig::NotionConfig,
+                Dodopayments::IntegrationConfig::DigitalFilesConfig,
+                Dodopayments::IntegrationConfig::LicenseKeyConfig
+              ),
+            integration_type:
+              Dodopayments::EntitlementIntegrationType::OrSymbol,
+            name: String,
+            description: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, String]),
+            request_options: Dodopayments::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/entitlement_delete_params.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class EntitlementDeleteParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::EntitlementDeleteParams,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          id: String,
+          request_options: Dodopayments::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { id: String, request_options: Dodopayments::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/entitlement_grant_created_webhook_event.rbi

@@ -0,0 +1,103 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class EntitlementGrantCreatedWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::EntitlementGrantCreatedWebhookEvent,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      # The business identifier
+      sig { returns(String) }
+      attr_accessor :business_id
+
+      sig { returns(Dodopayments::Entitlements::EntitlementGrant) }
+      attr_reader :data
+
+      sig do
+        params(data: Dodopayments::Entitlements::EntitlementGrant::OrHash).void
+      end
+      attr_writer :data
+
+      # The timestamp of when the event occurred
+      sig { returns(Time) }
+      attr_accessor :timestamp
+
+      # The event type
+      sig do
+        returns(
+          Dodopayments::EntitlementGrantCreatedWebhookEvent::Type::TaggedSymbol
+        )
+      end
+      attr_accessor :type
+
+      sig do
+        params(
+          business_id: String,
+          data: Dodopayments::Entitlements::EntitlementGrant::OrHash,
+          timestamp: Time,
+          type:
+            Dodopayments::EntitlementGrantCreatedWebhookEvent::Type::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The business identifier
+        business_id:,
+        data:,
+        # The timestamp of when the event occurred
+        timestamp:,
+        # The event type
+        type:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            business_id: String,
+            data: Dodopayments::Entitlements::EntitlementGrant,
+            timestamp: Time,
+            type:
+              Dodopayments::EntitlementGrantCreatedWebhookEvent::Type::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The event type
+      module Type
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Dodopayments::EntitlementGrantCreatedWebhookEvent::Type
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENTITLEMENT_GRANT_CREATED =
+          T.let(
+            :"entitlement_grant.created",
+            Dodopayments::EntitlementGrantCreatedWebhookEvent::Type::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Dodopayments::EntitlementGrantCreatedWebhookEvent::Type::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/entitlement_grant_delivered_webhook_event.rbi

@@ -0,0 +1,103 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class EntitlementGrantDeliveredWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::EntitlementGrantDeliveredWebhookEvent,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      # The business identifier
+      sig { returns(String) }
+      attr_accessor :business_id
+
+      sig { returns(Dodopayments::Entitlements::EntitlementGrant) }
+      attr_reader :data
+
+      sig do
+        params(data: Dodopayments::Entitlements::EntitlementGrant::OrHash).void
+      end
+      attr_writer :data
+
+      # The timestamp of when the event occurred
+      sig { returns(Time) }
+      attr_accessor :timestamp
+
+      # The event type
+      sig do
+        returns(
+          Dodopayments::EntitlementGrantDeliveredWebhookEvent::Type::TaggedSymbol
+        )
+      end
+      attr_accessor :type
+
+      sig do
+        params(
+          business_id: String,
+          data: Dodopayments::Entitlements::EntitlementGrant::OrHash,
+          timestamp: Time,
+          type:
+            Dodopayments::EntitlementGrantDeliveredWebhookEvent::Type::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The business identifier
+        business_id:,
+        data:,
+        # The timestamp of when the event occurred
+        timestamp:,
+        # The event type
+        type:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            business_id: String,
+            data: Dodopayments::Entitlements::EntitlementGrant,
+            timestamp: Time,
+            type:
+              Dodopayments::EntitlementGrantDeliveredWebhookEvent::Type::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The event type
+      module Type
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Dodopayments::EntitlementGrantDeliveredWebhookEvent::Type
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENTITLEMENT_GRANT_DELIVERED =
+          T.let(
+            :"entitlement_grant.delivered",
+            Dodopayments::EntitlementGrantDeliveredWebhookEvent::Type::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Dodopayments::EntitlementGrantDeliveredWebhookEvent::Type::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/entitlement_grant_failed_webhook_event.rbi

@@ -0,0 +1,102 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class EntitlementGrantFailedWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::EntitlementGrantFailedWebhookEvent,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      # The business identifier
+      sig { returns(String) }
+      attr_accessor :business_id
+
+      sig { returns(Dodopayments::Entitlements::EntitlementGrant) }
+      attr_reader :data
+
+      sig do
+        params(data: Dodopayments::Entitlements::EntitlementGrant::OrHash).void
+      end
+      attr_writer :data
+
+      # The timestamp of when the event occurred
+      sig { returns(Time) }
+      attr_accessor :timestamp
+
+      # The event type
+      sig do
+        returns(
+          Dodopayments::EntitlementGrantFailedWebhookEvent::Type::TaggedSymbol
+        )
+      end
+      attr_accessor :type
+
+      sig do
+        params(
+          business_id: String,
+          data: Dodopayments::Entitlements::EntitlementGrant::OrHash,
+          timestamp: Time,
+          type: Dodopayments::EntitlementGrantFailedWebhookEvent::Type::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The business identifier
+        business_id:,
+        data:,
+        # The timestamp of when the event occurred
+        timestamp:,
+        # The event type
+        type:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            business_id: String,
+            data: Dodopayments::Entitlements::EntitlementGrant,
+            timestamp: Time,
+            type:
+              Dodopayments::EntitlementGrantFailedWebhookEvent::Type::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The event type
+      module Type
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Dodopayments::EntitlementGrantFailedWebhookEvent::Type
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ENTITLEMENT_GRANT_FAILED =
+          T.let(
+            :"entitlement_grant.failed",
+            Dodopayments::EntitlementGrantFailedWebhookEvent::Type::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Dodopayments::EntitlementGrantFailedWebhookEvent::Type::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end