abacatepay-ruby 0.1.0 → 1.0.0

data/lib/{abacatepay/resources/billing.rb → abacate_pay/resources/billings.rb}

@@ -1,27 +1,24 @@
 # frozen_string_literal: true
 
-require "abacate_pay/resources/billing/metadata"
-require "abacate_pay/resources/billing/product"
-
 module AbacatePay
   module Resources
     # Represents a billing resource in the AbacatePay payment system.
     #
     # Manages billing-related data including payment methods, products, scheduling,
     # and customer information for recurring and one-time payments.
-    class Billing < Resource
+    class Billings < Resource
       # Maps property names to their corresponding resource classes
       RESOURCE_PROPERTIES = {
-        metadata: 'AbacatePay::Resources::Billing::Metadata',
-        customer: 'AbacatePay::Resources::Customer',
-        products: 'AbacatePay::Resources::Billing::Product'
+        metadata: "AbacatePay::Resources::Billings::Metadata",
+        customer: "AbacatePay::Resources::Customers",
+        products: "AbacatePay::Resources::Billings::Product"
       }.freeze
 
       # Maps property names to their corresponding enum classes
       ENUM_PROPERTIES = {
-        status: 'AbacatePay::Enums::Billing::Statuses',
-        frequency: 'AbacatePay::Enums::Billing::Frequencies',
-        methods: 'AbacatePay::Enums::Billing::Methods'
+        status: "AbacatePay::Enums::Billings::Statuses",
+        frequency: "AbacatePay::Enums::Billings::Frequencies",
+        methods: "AbacatePay::Enums::Billings::Methods"
       }.freeze
 
       # Properties that should be handled as DateTime objects
@@ -86,7 +83,7 @@ module AbacatePay
       # @return [Object] The processed value
       def process_enum_value(property, value)
         enum_class = Object.const_get(ENUM_PROPERTIES[property.to_sym])
-        
+
         if value.is_a?(Array)
           value.map { |item| initialize_enum(enum_class, item) }
         else
@@ -101,8 +98,8 @@ module AbacatePay
       # @return [Object] The processed value
       def process_resource_value(property, value)
         resource_class = Object.const_get(RESOURCE_PROPERTIES[property.to_sym])
-        
-        if property.to_s == 'products' && value.is_a?(Array)
+
+        if property.to_s == "products" && value.is_a?(Array)
           value.map { |item| initialize_resource(resource_class, item) }
         else
           initialize_resource(resource_class, value)
@@ -113,8 +110,11 @@ module AbacatePay
 
       # @!visibility private
       attr_writer :id, :account_id, :url, :methods, :products,
-                 :dev_mode, :amount, :metadata, :frequency, :status,
-                 :customer, :next_billing, :created_at, :updated_at
+                  :dev_mode, :amount, :metadata, :frequency, :status,
+                  :customer, :next_billing, :created_at, :updated_at
     end
   end
-end
+end
+
+require "abacate_pay/resources/billings/metadata"
+require "abacate_pay/resources/billings/product"

data/lib/abacate_pay/resources/checkouts.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents a checkout session in the AbacatePay system.
+    class Checkouts < Resource
+      RESOURCE_PROPERTIES = {
+        metadata: "AbacatePay::Resources::Billings::Metadata",
+        customer: "AbacatePay::Resources::Customers",
+        products: "AbacatePay::Resources::Billings::Product"
+      }.freeze
+
+      ENUM_PROPERTIES = {
+        status: "AbacatePay::Enums::Checkouts::Statuses",
+        frequency: "AbacatePay::Enums::Billings::Frequencies",
+        methods: "AbacatePay::Enums::Billings::Methods"
+      }.freeze
+
+      DATETIME_PROPERTIES = %w[created_at updated_at].freeze
+
+      attr_reader :id, :url, :amount, :status, :dev_mode, :methods,
+                  :products, :metadata, :customer, :coupons, :external_id,
+                  :frequency, :created_at, :updated_at
+
+      def initialize(data)
+        fill(data)
+      end
+
+      def dev_mode?
+        @dev_mode
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if DATETIME_PROPERTIES.include?(property)
+          initialize_date_time(value)
+        elsif ENUM_PROPERTIES.key?(property.to_sym)
+          process_enum_value(property, value)
+        elsif RESOURCE_PROPERTIES.key?(property.to_sym)
+          process_resource_value(property, value)
+        else
+          value
+        end
+      end
+
+      def process_enum_value(property, value)
+        enum_class = Object.const_get(ENUM_PROPERTIES[property.to_sym])
+
+        if value.is_a?(Array)
+          value.map { |item| initialize_enum(enum_class, item) }
+        else
+          initialize_enum(enum_class, value)
+        end
+      end
+
+      def process_resource_value(property, value)
+        resource_class = Object.const_get(RESOURCE_PROPERTIES[property.to_sym])
+
+        if property.to_s == "products" && value.is_a?(Array)
+          value.map { |item| initialize_resource(resource_class, item) }
+        else
+          initialize_resource(resource_class, value)
+        end
+      end
+
+      protected
+
+      attr_writer :id, :url, :amount, :status, :dev_mode, :methods,
+                  :products, :metadata, :customer, :coupons, :external_id,
+                  :frequency, :created_at, :updated_at
+    end
+  end
+end

data/lib/abacate_pay/resources/coupons.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents a discount coupon in the AbacatePay system.
+    class Coupons < Resource
+      ENUM_PROPERTIES = {
+        status: "AbacatePay::Enums::Coupons::Statuses",
+        discount_kind: "AbacatePay::Enums::Coupons::DiscountKinds"
+      }.freeze
+
+      DATETIME_PROPERTIES = %w[created_at updated_at].freeze
+
+      attr_reader :id, :code, :discount, :discount_kind, :max_redeems,
+                  :current_redeems, :status, :created_at, :updated_at
+
+      def initialize(data)
+        fill(data)
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if DATETIME_PROPERTIES.include?(property)
+          initialize_date_time(value)
+        elsif ENUM_PROPERTIES.key?(property.to_sym)
+          initialize_enum(Object.const_get(ENUM_PROPERTIES[property.to_sym]), value)
+        else
+          value
+        end
+      end
+
+      protected
+
+      attr_writer :id, :code, :discount, :discount_kind, :max_redeems,
+                  :current_redeems, :status, :created_at, :updated_at
+    end
+  end
+end

data/lib/{abacatepay/resources/customer → abacate_pay/resources/customers}/metadata.rb

@@ -2,7 +2,7 @@
 
 module AbacatePay
   module Resources
-    module Customer
+    class Customers
       # Represents metadata for a customer in the AbacatePay system.
       #
       # This class contains additional information about a customer, such as their name,
@@ -26,13 +26,7 @@ module AbacatePay
         def initialize(data)
           fill(data)
         end
-
-        protected
-
-        def to_hash
-          super
-        end
       end
     end
   end
-end
+end

data/lib/{abacatepay/resources/customer.rb → abacate_pay/resources/customers.rb}

@@ -1,17 +1,15 @@
 # frozen_string_literal: true
 
-require "abacate_pay/resources/customer/metadata"
-
 module AbacatePay
   module Resources
     # Represents a customer resource in the AbacatePay payment system.
     #
     # This class handles customer data including identification and metadata,
     # providing a structured way to manage customer information within the system.
-    class Customer < Resource
+    class Customers < Resource
       # Maps property names to their corresponding resource classes
       RESOURCE_PROPERTIES = {
-        metadata: 'AbacatePay::Resources::Customer::Metadata'
+        metadata: "AbacatePay::Resources::Customers::Metadata"
       }.freeze
 
       # @return [String, nil] The unique identifier for the customer
@@ -54,4 +52,6 @@ module AbacatePay
       attr_writer :id, :metadata
     end
   end
-end
+end
+
+require "abacate_pay/resources/customers/metadata"

data/lib/abacate_pay/resources/payouts.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents a payout (withdrawal) in the AbacatePay system.
+    class Payouts < Resource
+      ENUM_PROPERTIES = {
+        status: "AbacatePay::Enums::Payouts::Statuses"
+      }.freeze
+
+      DATETIME_PROPERTIES = %w[created_at updated_at].freeze
+
+      attr_reader :id, :amount, :external_id, :description,
+                  :status, :created_at, :updated_at
+
+      def initialize(data)
+        fill(data)
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if DATETIME_PROPERTIES.include?(property)
+          initialize_date_time(value)
+        elsif ENUM_PROPERTIES.key?(property.to_sym)
+          initialize_enum(Object.const_get(ENUM_PROPERTIES[property.to_sym]), value)
+        else
+          value
+        end
+      end
+
+      protected
+
+      attr_writer :id, :amount, :external_id, :description,
+                  :status, :created_at, :updated_at
+    end
+  end
+end

data/lib/abacate_pay/resources/pix_transfers.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents an outbound PIX transfer in the AbacatePay system.
+    class PixTransfers < Resource
+      ENUM_PROPERTIES = {
+        status: "AbacatePay::Enums::Transfers::Statuses",
+        key_type: "AbacatePay::Enums::Pix::KeyTypes"
+      }.freeze
+
+      DATETIME_PROPERTIES = %w[created_at updated_at].freeze
+
+      attr_reader :id, :amount, :external_id, :description,
+                  :key, :key_type, :status, :created_at, :updated_at
+
+      def initialize(data)
+        fill(data)
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if DATETIME_PROPERTIES.include?(property)
+          initialize_date_time(value)
+        elsif ENUM_PROPERTIES.key?(property.to_sym)
+          initialize_enum(Object.const_get(ENUM_PROPERTIES[property.to_sym]), value)
+        else
+          value
+        end
+      end
+
+      protected
+
+      attr_writer :id, :amount, :external_id, :description,
+                  :key, :key_type, :status, :created_at, :updated_at
+    end
+  end
+end

data/lib/abacate_pay/resources/products.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents a catalogue product in the AbacatePay system.
+    class Products < Resource
+      ENUM_PROPERTIES = {
+        cycle: "AbacatePay::Enums::Products::Cycles"
+      }.freeze
+
+      DATETIME_PROPERTIES = %w[created_at updated_at].freeze
+
+      attr_reader :id, :external_id, :name, :price, :currency,
+                  :description, :image_url, :cycle, :created_at, :updated_at
+
+      def initialize(data)
+        fill(data)
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if DATETIME_PROPERTIES.include?(property)
+          initialize_date_time(value)
+        elsif ENUM_PROPERTIES.key?(property.to_sym)
+          initialize_enum(Object.const_get(ENUM_PROPERTIES[property.to_sym]), value)
+        else
+          value
+        end
+      end
+
+      protected
+
+      attr_writer :id, :external_id, :name, :price, :currency,
+                  :description, :image_url, :cycle, :created_at, :updated_at
+    end
+  end
+end

data/lib/{abacatepay → abacate_pay}/resources/resource.rb

@@ -12,8 +12,9 @@ module AbacatePay
       # @return [DateTime, nil] The initialized DateTime object or nil
       # @raise [ArgumentError] If the value is invalid
       def initialize_date_time(value)
-        return nil if value.nil? || value.empty?
+        return nil if value.nil?
         return value.clone if value.is_a?(DateTime)
+        return nil if value.empty?
 
         DateTime.parse(value)
       rescue Date::Error
@@ -28,7 +29,7 @@ module AbacatePay
       # @raise [ArgumentError] If the value is invalid
       def initialize_enum(enum_class, value)
         return nil if value.nil? || value.empty?
-        
+
         enum_class.validate!(value)
       end
 
@@ -39,8 +40,9 @@ module AbacatePay
       # @return [Object, nil] The initialized resource or nil
       # @raise [ArgumentError] If the value is invalid
       def initialize_resource(resource_class, value)
-        return nil if value.nil? || value.empty?
+        return nil if value.nil?
         return value.clone if value.is_a?(resource_class)
+        return nil if value.respond_to?(:empty?) && value.empty?
 
         unless value.is_a?(Hash)
           raise ArgumentError, "Invalid resource value. Expected Hash or #{resource_class}, got #{value.class}"
@@ -49,6 +51,16 @@ module AbacatePay
         resource_class.new(value)
       end
 
+      # Default value processor — returns the value as-is.
+      # Subclasses override this to handle enums, datetimes, and nested resources.
+      #
+      # @param _property [String] The property name
+      # @param value [Object] The raw value
+      # @return [Object] The processed value
+      def process_value(_property, value)
+        value
+      end
+
       # Fill the object with data
       #
       # @param data [Hash] The data to fill with
@@ -57,7 +69,7 @@ module AbacatePay
         data.each do |key, value|
           property = camel_to_snake(key)
           next unless respond_to?("#{property}=", true)
-          
+
           send("#{property}=", process_value(property, value))
         end
       end
@@ -78,7 +90,7 @@ module AbacatePay
       # @param str [String] The string to convert
       # @return [String] The converted string
       def snake_to_camel(str)
-        str.split('_')
+        str.split("_")
            .map.with_index { |word, i| i.zero? ? word : word.capitalize }
            .join
       end
@@ -90,25 +102,25 @@ module AbacatePay
       # @return [Hash] The hash representation
       def to_hash
         instance_variables.each_with_object({}) do |var, hash|
-          next if var.to_s.start_with?('@__')
-          
+          next if var.to_s.start_with?("@__")
+
           value = instance_variable_get(var)
-          key = snake_to_camel(var.to_s.delete('@'))
-          
+          key = snake_to_camel(var.to_s.delete("@"))
+
           hash[key] = case value
-                     when DateTime
-                       value.iso8601
-                     when Resource
-                       value.to_hash
-                     when Module
-                       value.respond_to?(:value) ? value.value : value
-                     when Array
-                       value.map { |v| v.respond_to?(:to_hash) ? v.to_hash : v }
-                     else
-                       value
-                     end
+                      when DateTime
+                        value.iso8601
+                      when Resource
+                        value.to_hash
+                      when Module
+                        value.respond_to?(:value) ? value.value : value
+                      when Array
+                        value.map { |v| v.respond_to?(:to_hash) ? v.to_hash : v }
+                      else
+                        value
+                      end
         end.compact
       end
     end
   end
-end
+end

data/lib/abacate_pay/resources/store/balance.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    class Store < Resource
+      # Represents the available balance of a store.
+      class Balance < Resource
+        attr_reader :available, :pending, :blocked
+
+        def initialize(data)
+          fill(data)
+        end
+
+        protected
+
+        attr_writer :available, :pending, :blocked
+      end
+    end
+  end
+end

data/lib/abacate_pay/resources/store.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents store-level account data in the AbacatePay system.
+    class Store < Resource
+      RESOURCE_PROPERTIES = {
+        balance: "AbacatePay::Resources::Store::Balance"
+      }.freeze
+
+      attr_reader :id, :name, :balance
+
+      def initialize(data)
+        fill(data)
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if RESOURCE_PROPERTIES.key?(property.to_sym)
+          initialize_resource(Object.const_get(RESOURCE_PROPERTIES[property.to_sym]), value)
+        else
+          value
+        end
+      end
+
+      protected
+
+      attr_writer :id, :name, :balance
+    end
+  end
+end
+
+require "abacate_pay/resources/store/balance"

data/lib/abacate_pay/resources/subscriptions.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents a recurring subscription in the AbacatePay system.
+    class Subscriptions < Resource
+      RESOURCE_PROPERTIES = {
+        customer: "AbacatePay::Resources::Customers",
+        products: "AbacatePay::Resources::Billings::Product"
+      }.freeze
+
+      ENUM_PROPERTIES = {
+        status: "AbacatePay::Enums::Checkouts::Statuses",
+        methods: "AbacatePay::Enums::Billings::Methods"
+      }.freeze
+
+      DATETIME_PROPERTIES = %w[created_at updated_at].freeze
+
+      attr_reader :id, :url, :customer, :products, :methods, :status,
+                  :external_id, :metadata, :dev_mode, :created_at, :updated_at
+
+      def initialize(data)
+        fill(data)
+      end
+
+      def dev_mode?
+        @dev_mode
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if DATETIME_PROPERTIES.include?(property)
+          initialize_date_time(value)
+        elsif ENUM_PROPERTIES.key?(property.to_sym)
+          process_enum_value(property, value)
+        elsif RESOURCE_PROPERTIES.key?(property.to_sym)
+          process_resource_value(property, value)
+        else
+          value
+        end
+      end
+
+      def process_enum_value(property, value)
+        enum_class = Object.const_get(ENUM_PROPERTIES[property.to_sym])
+
+        if value.is_a?(Array)
+          value.map { |item| initialize_enum(enum_class, item) }
+        else
+          initialize_enum(enum_class, value)
+        end
+      end
+
+      def process_resource_value(property, value)
+        resource_class = Object.const_get(RESOURCE_PROPERTIES[property.to_sym])
+
+        if property.to_s == "products" && value.is_a?(Array)
+          value.map { |item| initialize_resource(resource_class, item) }
+        else
+          initialize_resource(resource_class, value)
+        end
+      end
+
+      protected
+
+      attr_writer :id, :url, :customer, :products, :methods, :status,
+                  :external_id, :metadata, :dev_mode, :created_at, :updated_at
+    end
+  end
+end

data/lib/abacate_pay/resources/transparents.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module AbacatePay
+  module Resources
+    # Represents a transparent PIX checkout in the AbacatePay system.
+    class Transparents < Resource
+      RESOURCE_PROPERTIES = {
+        customer: "AbacatePay::Resources::Customers"
+      }.freeze
+
+      DATETIME_PROPERTIES = %w[created_at updated_at].freeze
+
+      attr_reader :id, :amount, :status, :method, :description,
+                  :expires_in, :qr_code, :qr_code_image, :customer,
+                  :metadata, :dev_mode, :created_at, :updated_at
+
+      def initialize(data)
+        fill(data)
+      end
+
+      def dev_mode?
+        @dev_mode
+      end
+
+      private
+
+      def process_value(property, value)
+        return nil if value.nil?
+
+        if DATETIME_PROPERTIES.include?(property)
+          initialize_date_time(value)
+        elsif RESOURCE_PROPERTIES.key?(property.to_sym)
+          initialize_resource(Object.const_get(RESOURCE_PROPERTIES[property.to_sym]), value)
+        else
+          value
+        end
+      end
+
+      protected
+
+      attr_writer :id, :amount, :status, :method, :description,
+                  :expires_in, :qr_code, :qr_code_image, :customer,
+                  :metadata, :dev_mode, :created_at, :updated_at
+    end
+  end
+end