cashctrl 0.0.1 → 0.1.0

data/lib/cashctrl/models/salary_status.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class SalaryStatus < Resource
+      attribute :name, type: :string
+      attribute :sequence, type: :integer
+    end
+  end
+end

data/lib/cashctrl/models/salary_sum.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class SalarySum < Resource
+      attribute :type_id, type: :integer
+      attribute :name, type: :string
+      attribute :description, type: :string
+      attribute :sequence, type: :integer
+    end
+  end
+end

data/lib/cashctrl/models/salary_template.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class SalaryTemplate < Resource
+      attribute :name, type: :string
+      attribute :description, type: :string
+    end
+  end
+end

data/lib/cashctrl/models/salary_type.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class SalaryType < Resource
+      attribute :name, type: :string
+      attribute :description, type: :string
+      attribute :account_id, type: :integer
+      attribute :account_name, type: :string, readonly: true
+    end
+  end
+end

data/lib/cashctrl/models/sequence_number.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class SequenceNumber < Resource
+      attribute :name, type: :string
+      attribute :pattern, type: :string
+      attribute :counter, type: :integer
+    end
+  end
+end

data/lib/cashctrl/models/setting.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class Setting < Resource
+      attribute :fiscal_period_id, type: :integer
+      attribute :fiscal_period_name, type: :string, readonly: true
+      attribute :default_currency_id, type: :integer
+      attribute :default_currency_code, type: :string, readonly: true
+      attribute :default_location_id, type: :integer
+      attribute :default_location_name, type: :string, readonly: true
+      attribute :default_debit_id, type: :integer
+      attribute :default_debit_name, type: :string, readonly: true
+      attribute :default_credit_id, type: :integer
+      attribute :default_credit_name, type: :string, readonly: true
+      attribute :default_opening_id, type: :integer
+      attribute :default_opening_name, type: :string, readonly: true
+      attribute :default_tax_id, type: :integer
+      attribute :default_tax_name, type: :string, readonly: true
+      attribute :default_order_category_id, type: :integer
+      attribute :default_person_category_customer_id, type: :integer
+      attribute :default_person_category_vendor_id, type: :integer
+      attribute :logo_file_id, type: :integer
+      attribute :csv_delimiter, type: :string
+      attribute :journal_import_duplicate_check, type: :string
+      attribute :journal_import_force_duplicate_detection, type: :boolean
+      attribute :tax_accounting_method, type: :string
+      attribute :tax_type, type: :string
+    end
+  end
+end

data/lib/cashctrl/models/tax.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class Tax < Resource
+      attribute :name, type: :string
+      attribute :percentage, type: :decimal
+      attribute :document_name, type: :string
+      attribute :calc_type, type: :string
+      attribute :account_id, type: :integer
+      attribute :account_name, type: :string, readonly: true
+      attribute :is_inactive, type: :boolean
+    end
+  end
+end

data/lib/cashctrl/models/text.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class Text < Resource
+      attribute :type, type: :string
+      attribute :name, type: :string
+      attribute :value, type: :string
+    end
+  end
+end

data/lib/cashctrl/models/title.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class Title < Resource
+      attribute :name, type: :string
+      attribute :sentence, type: :string
+      attribute :gender, type: :string
+    end
+  end
+end

data/lib/cashctrl/models/unit.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# This file is auto-generated from schema.yml. Do not edit manually.
+
+module Cashctrl
+  module Models
+    class Unit < Resource
+      attribute :name, type: :string
+    end
+  end
+end

data/lib/cashctrl/resource.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+require "bigdecimal"
+require "date"
+require "json"
+
+module Cashctrl
+  class Resource
+    class << self
+      def attribute(name, type: :string, readonly: false)
+        attributes[name.to_sym] = { type: type, readonly: readonly }
+
+        define_method(name) do
+          @attributes[name.to_sym]
+        end
+
+        return if readonly
+
+        define_method("#{name}=") do |value|
+          @attributes[name.to_sym] = value
+        end
+      end
+
+      def attributes
+        @attributes ||= {}
+      end
+
+      def inherited(subclass)
+        super
+
+        subclass.instance_variable_set(:@attributes, attributes.dup)
+      end
+
+      def from_response(response)
+        return nil if response.nil?
+
+        data = response.is_a?(Hash) && response.key?("data") ? response["data"] : response
+        new(data)
+      end
+    end
+
+    attribute :id, type: :integer, readonly: true
+    attribute :created, type: :datetime, readonly: true
+    attribute :created_by, type: :string, readonly: true
+    attribute :last_updated, type: :datetime, readonly: true
+    attribute :last_updated_by, type: :string, readonly: true
+
+    attr_reader :raw_data
+
+    def initialize(attributes = {})
+      @raw_data = attributes.dup.freeze
+      @attributes = {}
+      @original_attributes = attributes.transform_keys { |k| underscore(k.to_s).to_sym }
+
+      self.class.attributes.each do |name, meta|
+        camel_key = camelize(name.to_s)
+        snake_key = name.to_sym
+
+        value = attributes[camel_key] || attributes[camel_key.to_sym] || attributes[snake_key.to_s] || attributes[snake_key]
+
+        @attributes[snake_key] = coerce_value(value, meta[:type])
+      end
+
+      @extra_attributes = {}
+
+      attributes.each do |key, value|
+        snake_key = underscore(key.to_s).to_sym
+
+        @extra_attributes[snake_key] = value unless self.class.attributes.key?(snake_key)
+      end
+    end
+
+    def [](key)
+      snake_key = underscore(key.to_s).to_sym
+      @attributes[snake_key] || @extra_attributes[snake_key]
+    end
+
+    def []=(key, value)
+      snake_key = underscore(key.to_s).to_sym
+      if self.class.attributes.key?(snake_key)
+        @attributes[snake_key] = value
+      else
+        @extra_attributes[snake_key] = value
+      end
+    end
+
+    def to_h
+      result = {}
+
+      @attributes.each do |key, value|
+        result[camelize(key.to_s)] = value
+      end
+
+      @extra_attributes.each do |key, value|
+        result[camelize(key.to_s)] = value
+      end
+
+      result
+    end
+
+    def to_json(*)
+      to_h.to_json(*)
+    end
+
+    def inspect
+      attrs = @attributes.map { |key, value| "#{key}: #{value.inspect}" }.join(", ")
+
+      "#<#{self.class.name} #{attrs}>"
+    end
+
+    def persisted?
+      !id.nil?
+    end
+
+    def ==(other)
+      other.is_a?(self.class) && id == other.id
+    end
+
+    alias eql? ==
+
+    def hash
+      [self.class, id].hash
+    end
+
+    def method_missing(method_name, *args)
+      snake_key = method_name.to_s.delete_suffix("=").to_sym
+
+      if method_name.to_s.end_with?("=")
+        @extra_attributes[snake_key] = args.first
+      elsif @extra_attributes.key?(snake_key)
+        coerce_dynamic_value(@extra_attributes[snake_key])
+      elsif @original_attributes.key?(snake_key)
+        coerce_dynamic_value(@original_attributes[snake_key])
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      snake_key = method_name.to_s.delete_suffix("=").to_sym
+      @extra_attributes.key?(snake_key) || @original_attributes.key?(snake_key) || super
+    end
+
+    private
+
+    def coerce_dynamic_value(value)
+      return value unless value.is_a?(String)
+
+      LocalizedString.localized?(value) ? LocalizedString.parse(value) : value
+    end
+
+    def coerce_value(value, type)
+      return nil if value.nil?
+
+      case type
+      when :integer
+        value.to_i
+      when :decimal, :float
+        value.is_a?(BigDecimal) ? value : BigDecimal(value.to_s)
+      when :boolean
+        [true, "true", 1].include?(value)
+      when :date
+        value.is_a?(Date) ? value : Date.parse(value.to_s)
+      when :datetime
+        case value
+        when DateTime then value
+        when Time then value.to_datetime
+        else DateTime.parse(value.to_s)
+        end
+      when :json
+        value.is_a?(String) ? JSON.parse(value) : value
+      when :localized
+        LocalizedString.parse(value)
+      when :string
+        # Auto-detect localized strings
+        LocalizedString.localized?(value) ? LocalizedString.parse(value) : value
+      else
+        value
+      end
+    rescue ArgumentError, JSON::ParserError
+      value
+    end
+
+    def underscore(string)
+      string.gsub(/([A-Z])/, '_\1').sub(/^_/, "").downcase
+    end
+
+    def camelize(string)
+      string.split("_").each_with_index.map { |part, index| index.zero? ? part : part.capitalize }.join
+    end
+  end
+end

data/lib/cashctrl/resources/account/bank.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Cashctrl
+  module Resources
+    class Account
+      class Bank < Base
+        api_path "account/bank"
+        model_class Models::Bank
+
+        class << self
+          def update_attachments(id:, file_ids:)
+            file_ids_param = Array(file_ids).join(",")
+            client.post("#{api_path}/update_attachments.json", id: id, fileIds: file_ids_param)
+          end
+        end
+
+        def update_attachments(id:, file_ids:)
+          file_ids_param = Array(file_ids).join(",")
+          client.post("#{api_path}/update_attachments.json", id: id, fileIds: file_ids_param)
+        end
+      end
+    end
+  end
+end

data/lib/cashctrl/resources/account/category.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cashctrl
+  module Resources
+    class Account
+      class Category < Base
+        api_path "account/category"
+        model_class Models::Category
+
+        class << self
+          def tree
+            client.get("#{api_path}/tree.json")
+          end
+        end
+
+        def tree
+          client.get("#{api_path}/tree.json")
+        end
+      end
+    end
+  end
+end

data/lib/cashctrl/resources/account/cost_center/category.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Cashctrl
+  module Resources
+    class Account
+      class CostCenter
+        class Category < Base
+          api_path "account/costcenter/category"
+          model_class Models::Category
+
+          class << self
+            def tree
+              client.get("#{api_path}/tree.json")
+            end
+          end
+
+          def tree
+            client.get("#{api_path}/tree.json")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cashctrl/resources/account/cost_center.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Cashctrl
+  module Resources
+    class Account
+      class CostCenter < Base
+        api_path "account/costcenter"
+        model_class Models::CostCenter
+
+        class << self
+          def balance(id:, date: nil)
+            params = { id: id }
+            params[:date] = date if date
+            result = client.get_raw("#{api_path}/balance", params)
+            BigDecimal(result.to_s)
+          end
+
+          def categorize(ids:, target:)
+            ids_param = Array(ids).join(",")
+            client.post("#{api_path}/categorize.json", ids: ids_param, target: target)
+          end
+
+          def update_attachments(id:, file_ids:)
+            file_ids_param = Array(file_ids).join(",")
+            client.post("#{api_path}/update_attachments.json", id: id, fileIds: file_ids_param)
+          end
+        end
+
+        def balance(id:, date: nil)
+          params = { id: id }
+          params[:date] = date if date
+          result = client.get_raw("#{api_path}/balance", params)
+          BigDecimal(result.to_s)
+        end
+
+        def categorize(ids:, target:)
+          ids_param = Array(ids).join(",")
+          client.post("#{api_path}/categorize.json", ids: ids_param, target: target)
+        end
+
+        def update_attachments(id:, file_ids:)
+          file_ids_param = Array(file_ids).join(",")
+          client.post("#{api_path}/update_attachments.json", id: id, fileIds: file_ids_param)
+        end
+      end
+    end
+  end
+end

data/lib/cashctrl/resources/account.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Cashctrl
+  module Resources
+    class Account < Base
+      api_path "account"
+      model_class Models::Account
+
+      class << self
+        def find_by_number(number)
+          list.find { |account| account.number == number }
+        end
+
+        def balance(id:, date: nil)
+          params = { id: id }
+          params[:date] = date if date
+          result = client.get_raw("#{api_path}/balance", params)
+          BigDecimal(result.to_s)
+        end
+
+        def categorize(ids:, target:)
+          ids_param = Array(ids).join(",")
+          client.post("#{api_path}/categorize.json", ids: ids_param, target: target)
+        end
+
+        def update_attachments(id:, file_ids:)
+          file_ids_param = Array(file_ids).join(",")
+          client.post("#{api_path}/update_attachments.json", id: id, fileIds: file_ids_param)
+        end
+      end
+
+      def find_by_number(number)
+        list.find { |account| account.number == number }
+      end
+
+      def balance(id:, date: nil)
+        params = { id: id }
+        params[:date] = date if date
+        result = client.get_raw("#{api_path}/balance", params)
+        BigDecimal(result.to_s)
+      end
+
+      def categorize(ids:, target:)
+        ids_param = Array(ids).join(",")
+        client.post("#{api_path}/categorize.json", ids: ids_param, target: target)
+      end
+
+      def update_attachments(id:, file_ids:)
+        file_ids_param = Array(file_ids).join(",")
+        client.post("#{api_path}/update_attachments.json", id: id, fileIds: file_ids_param)
+      end
+    end
+  end
+end

data/lib/cashctrl/resources/base.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module Cashctrl
+  module Resources
+    class Base
+      class << self
+        def api_path(path = nil)
+          if path
+            @api_path = path
+          else
+            @api_path
+          end
+        end
+
+        def model_class(klass = nil)
+          if klass
+            @model_class = klass
+          else
+            @model_class || Resource
+          end
+        end
+
+        def client
+          Cashctrl.client
+        end
+
+        def list(**params)
+          response = client.get("#{api_path}/list.json", params)
+          Collection.from_response(response, resource_class: model_class)
+        end
+
+        def all(...)
+          list(...)
+        end
+
+        def read(id:)
+          response = client.get("#{api_path}/read.json", id: id)
+          model_class.from_response(response)
+        end
+
+        def find(id)
+          read(id: id)
+        end
+
+        def create(**params)
+          response = client.post("#{api_path}/create.json", params)
+          wrap_response(response)
+        end
+
+        def update(id:, **params)
+          response = client.post("#{api_path}/update.json", { id: id, **params })
+          wrap_response(response)
+        end
+
+        def delete(ids:)
+          ids_param = Array(ids).join(",")
+          client.post("#{api_path}/delete.json", ids: ids_param)
+        end
+
+        def first
+          list.first
+        end
+
+        def last
+          list.last
+        end
+
+        private
+
+        def wrap_response(response)
+          return response unless response.is_a?(Hash) && response["data"]
+
+          if response["data"].is_a?(Array)
+            Collection.from_response(response, resource_class: model_class)
+          else
+            model_class.from_response(response["data"])
+          end
+        end
+      end
+
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+
+      def api_path
+        self.class.api_path
+      end
+
+      def model_class
+        self.class.model_class
+      end
+
+      def list(**params)
+        response = client.get("#{api_path}/list.json", params)
+        Collection.from_response(response, resource_class: model_class)
+      end
+
+      def all(...)
+        list(...)
+      end
+
+      def read(id:)
+        response = client.get("#{api_path}/read.json", id: id)
+        model_class.from_response(response)
+      end
+
+      def find(id)
+        read(id: id)
+      end
+
+      def create(**params)
+        response = client.post("#{api_path}/create.json", params)
+        wrap_response(response)
+      end
+
+      def update(id:, **params)
+        response = client.post("#{api_path}/update.json", { id: id, **params })
+        wrap_response(response)
+      end
+
+      def delete(ids:)
+        ids_param = Array(ids).join(",")
+        client.post("#{api_path}/delete.json", ids: ids_param)
+      end
+
+      def first
+        list.first
+      end
+
+      def last
+        list.last
+      end
+
+      def list_csv(**params)
+        client.get_raw("#{api_path}/list.csv", params)
+      end
+
+      def list_xlsx(**params)
+        client.get_raw("#{api_path}/list.xlsx", params)
+      end
+
+      def list_pdf(**params)
+        client.get_raw("#{api_path}/list.pdf", params)
+      end
+
+      private
+
+      def wrap_response(response)
+        return response unless response.is_a?(Hash) && response["data"]
+
+        if response["data"].is_a?(Array)
+          Collection.from_response(response, resource_class: model_class)
+        else
+          model_class.from_response(response["data"])
+        end
+      end
+    end
+  end
+end