starkinfra 0.0.1

data/lib/pixreversal/log.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('pixreversal')
+
+module StarkInfra
+  class PixReversal
+    # # PixReversal::Log object
+    #
+    # Every time a PixReversal entity is modified, a corresponding PixReversal::Log
+    # is generated for the entity. This log is never generated by the
+    # user.
+    #
+    # ## Attributes:
+    # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+    # - type [string]: type of the PixReversal event which triggered the log creation. ex: 'processing' or 'success'
+    # - reversal [PixReversal]: PixReversal entity to which the log refers to.
+    # - errors [list of strings]: list of errors linked to this PixReversal event.
+    class Log < StarkInfra::Utils::Resource
+      attr_reader :id, :created, :type, :errors, :reversal
+      def initialize(id:, created:, type:, errors:, reversal:)
+        super(id)
+        @type = type
+        @errors = errors
+        @reversal = reversal
+        @created = StarkInfra::Utils::Checks.check_datetime(created)
+      end
+
+      # # Retrieve a specific Log
+      #
+      # Receive a single Log object previously created by the Stark Infra API by passing its id
+      #
+      # ## Parameters (required):
+      # - id [string]: object unique id. ex: '5656565656565656'
+      #
+      # ## Parameters (optional):
+      # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+      #
+      # ## Return:
+      # - Log object with updated attributes
+      def self.get(id, user: nil)
+        StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+      end
+
+      # # Retrieve Logs
+      #
+      # Receive a generator of Log objects previously created in the Stark Infra API
+      #
+      # ## Parameters (optional):
+      # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+      # - after [Date, DateTime, Time or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+      # - before [Date, DateTime, Time or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+      # - types [list of strings, default nil]: filter retrieved objects by types. ex: 'success' or 'failed'
+      # - reversal_ids [list of strings, default nil]: list of PixReversal ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+      # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+      #
+      # ## Return:
+      # - list of Log objects with updated attributes
+      def self.query(limit: nil, after: nil, before: nil, types: nil, reversal_ids: nil, user: nil)
+        after = StarkInfra::Utils::Checks.check_date(after)
+        before = StarkInfra::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_stream(
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          reversal_ids: reversal_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      # # Retrieve paged Logs
+      #
+      # Receive a list of up to 100 Log objects previously created in the Stark Infra API and the cursor to the next page.
+      # Use this function instead of query if you want to manually page your requests.
+      #
+      # ## Parameters (optional):
+      # - cursor [string, default nil]: cursor returned on the previous page function call
+      # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+      # - after [Date, DateTime, Time or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+      # - before [Date, DateTime, Time or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+      # - types [list of strings, default nil]: filter retrieved objects by types. ex: 'success' or 'failed'
+      # - reversal_ids [list of strings, default nil]: list of PixReversal ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+      # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+      #
+      # ## Return:
+      # - list of Log objects with updated attributes and cursor to retrieve the next page of Log objects
+      def self.page(cursor: nil, limit: nil, after: nil, before: nil, types: nil, reversal_ids: nil, user: nil)
+        after = StarkInfra::Utils::Checks.check_date(after)
+        before = StarkInfra::Utils::Checks.check_date(before)
+        return StarkInfra::Utils::Rest.get_page(
+          cursor: cursor,
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          reversal_ids: reversal_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      def self.resource
+        reversal_maker = StarkInfra::PixReversal.resource[:resource_maker]
+        {
+          resource_name: 'PixReversalLog',
+          resource_maker: proc { |json|
+            Log.new(
+              id: json['id'],
+              created: json['created'],
+              type: json['type'],
+              errors: json['errors'],
+              reversal: StarkInfra::Utils::API.from_api_json(reversal_maker, json['reversal'])
+            )
+          }
+        }
+      end
+    end
+  end
+end

data/lib/pixreversal/pixreversal.rb

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('../utils/parse')
+
+
+module StarkInfra
+  # # PixReversal object
+  #
+  # When you initialize a PixReversal, the entity will not be automatically
+  # created in the Stark Infra API. The 'create' function sends the objects
+  # to the Stark Infra API and returns the list of created objects.
+  #
+  # ## Parameters (required):
+  # - amount [integer]: amount in cents to be reversed from PixRequest. ex: 1234 (= R$ 12.34)
+  # - external_id [string]: url safe string that must be unique among all your PixReversals. Duplicated external ids will cause failures. By default, this parameter will block any PixReversal that repeats amount and receiver information on the same date. ex: "my-internal-id-123456"
+  # - end_to_end_id [string]: central bank's unique transaction ID. ex: "E79457883202101262140HHX553UPqeq"
+  # - reason [string]: reason why the PixRequest is being reversed. Options are "bankError", "fraud", "pixWithdrawError", "refund3ByEndCustomer"
+  #
+  # ## Parameters (optional):
+  # - tags [string, default nill]: [list of strings]: list of strings for reference when searching for PixReversals. ex: ["employees", "monthly"]
+  #
+  # ## Attributes (return-only):
+  # - id [string, default nil]: unique id returned when the PixReversal is created. ex: "5656565656565656".
+  # - return_id [string]: central bank's unique reversal transaction ID. ex: "D20018183202202030109X3OoBHG74wo".
+  # - bank_code [string]: code of the bank institution in Brazil. ex: "20018183" or "341"
+  # - fee [string]: fee charged by this PixReversal. ex: 200 (= R$ 2.00)
+  # - status [string]: current PixReversal status. ex: "registered" or "paid"
+  # - flow [string]: direction of money flow. ex: "in" or "out"
+  # - created [Datetime, default nil]: creation datetime for the PixReversal. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [Datetime, default nil]: latest update datetime for the PixReversal. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+
+  class PixReversal < StarkInfra::Utils::Resource;
+    attr_reader :amount, :external_id, :end_to_end_id, :reason, :tags, :id, :return_id, :bank_code, :fee, :status, :flow, :created, :updated
+    def initialize(
+      amount:, external_id:, end_to_end_id:, reason:, tags: nil, id: nil, return_id: nil, bank_code: nil, fee: nil, 
+      status: nil, flow: nil, created: nil, updated: nil
+    )
+      created = StarkInfra::Utils::Checks.check_datetime(created)
+      updated = StarkInfra::Utils::Checks.check_datetime(updated)
+      super(id)
+      @amount = amount
+      @external_id = external_id
+      @end_to_end_id = end_to_end_id
+      @reason = reason
+      @tags = tags
+      @return_id = return_id
+      @bank_code = bank_code
+      @fee = fee
+      @staus = status
+      @flow = flow
+      @created = created
+      @updated = updated
+    end
+
+    # # Create PixRversals
+    #
+    # Send a list of PixRversal objects for creation in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - reversals [list of PixRversal objects]: list of PixRversal objects to be created in the API
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of PixRversal objects with updated attributes
+    def self.create(reversals, user: nil)
+      StarkInfra::Utils::Rest.post(entities: reversals, user: user, **resource)
+    end
+
+    # # Retrieve a specific PixRversal
+    #
+    # Receive a single PixRversal object previously created in the Stark Bank API by passing its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - PixRversal object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve PixRversals
+    #
+    # Receive a generator of PixRversal objects previously created in the Stark Infra API
+    #
+    # ## Parameters (optional):
+    # - fields [list of strings, default None]: parameters to be retrieved from PixRequest objects. ex: ["amount", "id"]
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - after [Date, DateTime, Time or string, default nil]: date filter for objects created or updated only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date, DateTime, Time or string, default nil]: date filter for objects created or updated only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [string, default nil]: filter for status of retrieved objects. ex: 'success' or 'failed'
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - return_ids [list of strings, default None]: central bank's unique reversal transaction ID. ex: ["D20018183202202030109X3OoBHG74wo", "D20018183202202030109X3OoBHG72rd"].
+    # - external_ids [list of strings, default None]: url safe string that must be unique among all your PixReversals. Duplicated external IDs will cause failures. By default, this parameter will block any PixReversal that repeats amount and receiver information on the same date. ex: ["my-internal-id-123456", "my-internal-id-654321"]
+    # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of PixRversal objects with updated attributes
+    def self.query(fields:nil, limit: nil, after: nil, before: nil, status: nil, tags: nil, ids: nil, return_ids: nil, external_ids: nil, user: nil)
+      StarkInfra::Utils::Rest.get_stream(
+        fields: fields,
+        limit: limit,
+        after: StarkInfra::Utils::Checks.check_date(after),
+        before: StarkInfra::Utils::Checks.check_date(before),
+        status: status,
+        tags: tags,
+        ids: ids,
+        return_ids: return_ids,
+        external_ids: external_ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged PixRversals
+    #
+    # Receive a list of up to 100 PixRversal objects previously created in the Stark Infra API and the cursor to the next page.
+    # Use this function instead of query if you want to manually page your requests.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call
+    # - fields [list of strings, default None]: parameters to be retrieved from PixRequest objects. ex: ["amount", "id"]
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - after [Date, DateTime, Time or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date, DateTime, Time or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [string, default nil]: filter for status of retrieved objects. ex: 'paid' or 'registered'
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - return_ids [list of strings, default None]: central bank's unique reversal transaction ID. ex: ["D20018183202202030109X3OoBHG74wo", "D20018183202202030109X3OoBHG72rd"].
+    # - external_ids [list of strings, default None]: url safe string that must be unique among all your PixReversals. Duplicated external IDs will cause failures. By default, this parameter will block any PixReversal that repeats amount and receiver information on the same date. ex: ["my-internal-id-123456", "my-internal-id-654321"]
+    # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of PixRversal objects with updated attributes and cursor to retrieve the next page of PixRversal objects
+    def self.page(cursor: nil, fields:nil, limit: nil, after: nil, before: nil, status: nil, tags: nil, ids: nil, return_ids: nil, external_ids: nil, user: nil)
+      return StarkInfra::Utils::Rest.get_page(
+        fields: fields,
+        cursor: cursor,
+        limit: limit,
+        after: StarkInfra::Utils::Checks.check_date(after),
+        before: StarkInfra::Utils::Checks.check_date(before),
+        status: status,
+        tags: tags,
+        ids: ids,
+        return_ids: return_ids,
+        external_ids: external_ids,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.parse(content:, signature:, user: nil)
+      # # Create single verified PixReversal object from a content string
+      # 
+      # Create a single PixReversal object from a content string received from a handler listening at a subscribed user endpoint.
+      # If the provided digital signature does not check out with the StarkInfra public key, a
+      # starkinfra.exception.InvalidSignatureException will be raised.
+      # 
+      # ## Parameters (required):
+      # - content [string]: response content from revrsal received at user endpoint (not parsed)
+      # - signature [string]: base-64 digital signature received at response header "Digital-Signature"
+      # 
+      # ## Parameters (optional):
+      # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+      # 
+      # ## Return:
+      # - Parsed PixReversal object
+      return StarkInfra::Utils::Parse.parse_and_verify(content: content, signature: signature, user: user, resource: resource)
+    end      
+
+    def self.resource
+      {
+        resource_name: 'PixReversal',
+        resource_maker: proc { |json|
+          PixReversal.new(
+            amount: json['amount'],
+            external_id: json['external_id'],
+            end_to_end_id: json['end_to_end_id'],
+            reason: json['reason'],
+            tags: json['tags'],
+            id: json['id'],
+            return_id: json['return_id'],
+            bank_code: json['bank_code'],
+            fee: json['fee'],
+            status: json['status'],
+            flow: json['flow'],
+            created: json['created'],
+            updated: json['updated'],
+          )
+        }
+      }
+    end
+  end
+end

data/lib/pixstatement/pixstatement.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+
+module StarkInfra
+  # # PixStatement object
+  #
+  # The PixStatement object stores information about all the transactions that happened on
+  # a specific day at the workspace. It must be created by the user before it can be
+  # accessed by the user. This feature is only available for direct participants.
+  #
+  # ## Parameters (required):
+  # - after [Date, DateTime, Time or string]: transactions that happened at this date are stored in the PixStatement, must be the same as before. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - before [Date, DateTime, Time or string]: transactions that happened at this date are stored in the PixStatement, must be the same as after. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - type [string]: types of entities to include in statement. Options: ["interchange", "interchangeTotal", "transaction"]
+  #
+  # ## Attributes (return-only):
+  # - id [string, default nil]: unique id returned when the PixStatement is created. ex: "5656565656565656"
+  # - status [string, default nil]: current PixStatement status. ex: "success" or "failed"
+  # - transaction_count [integer]: number of transactions that happened during the day that the PixStatement was requested. ex 11
+  # - created [Datetime, default nil]: creation datetime for the PixStatement. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [Datetime, default nil]: latest update datetime for the PixStatement. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  
+  class PixStatement < StarkInfra::Utils::Resource
+    attr_reader :after, :before, :type, :id, :status, :transaction_count, :created, :updated
+    def initialize(after:, before:, type:, id: nil, status: nil, transaction_count: nil, created: nil, updated: nil)
+      super(id)
+      @after = StarkInfra::Utils::Checks.check_date(after)
+      @before = StarkInfra::Utils::Checks.check_date(before)
+      @type = type
+      @status = status
+      @transaction_count = transaction_count
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create a PixStatement object
+    #
+    # Create a PixStatements linked to your workspace in the Stark Infra API
+    # 
+    # ## Parameters (requiered):
+    # - statement [PixStatement object]: PixStatement object to be created in the API.
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - PixStatement object with updated attributes.
+    def self.create(statement, user: nil)
+      StarkInfra::Utils::Rest.post_single(entity: statement, user: user, **resource)
+    end
+
+    # # Retrieve a specific PixStatment object
+    #
+    # Receive a single PixStatment object previously created in the Stark Infra API by passing its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - PixStatment object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve PixStatement objects
+    #
+    # Receive a generator of PixStatements objects previously created in the Stark Infra API.
+    #
+    # ## Parameters (optional):
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of PixStatement objects with updated attributes
+    def self.query(limit: nil, ids: nil, user: nil)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged PixStatements
+    #
+    # Receive a list of up to 100 PixStatements objects previously created in the Stark infra API and the cursor to the next page.
+    # Use this function instead of query if you want to manually page your requests.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of PixStatement objects with updated attributes
+    # - Cursor to retrieve the next page of PixStatement objects
+    def self.page(cursor: nil, limit: nil, ids: nil, user: nil)
+      return StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # # Retrieve a .cvs PixStatement
+    #
+    # Retrieve a specific PixStatement by its ID in a .csv file.
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: "5656565656565656"
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - PixStatement .csv file
+    def self.csv(id, user: nil)
+      return StarkInfra::Utils::Rest.get_content(id: id, user: user, sub_resource_name: "csv", **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'PixStatement',
+        resource_maker: proc { |json|
+          PixStatement.new(
+            after: json['after'],
+            before: json['before'],
+            type: json['type'],
+            id: json['id'],
+            status: json['status'],
+            transaction_count: json['transaction_count'],
+            created: json['created'],
+            updated: json['updated'],
+          )
+        }
+      }
+    end
+  end
+end

data/lib/starkinfra.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require('starkbank')
+require_relative('key')
+require_relative('workspace/workspace')
+require_relative('pixrequest/pixrequest')
+require_relative('pixrequest/log')
+require_relative('pixreversal/pixreversal')
+require_relative('pixreversal/log')
+require_relative('pixbalance/pixbalance')
+require_relative('pixstatement/pixstatement')
+require_relative('event/event')
+
+# SDK to facilitate Ruby integrations with Stark Infra
+module StarkInfra
+  include StarkBank
+  @user = nil
+  @language = 'en-US'
+  class << self; attr_accessor :user, :language; end
+end

data/lib/utils/api.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require_relative('case')
+
+module StarkInfra
+  module Utils
+    module API
+      def self.build_entity_hash(entity)
+        if entity.is_a?(Hash)
+          entity_hash = entity
+        else
+          entity_hash = {}
+          entity.instance_variables.each do |key|
+            variable = entity.instance_variable_get(key)
+            entity_hash[key[1..-1]] = variable.is_a?(StarkInfra::Utils::Resource) ? build_entity_hash(variable) : entity.instance_variable_get(key)
+          end
+        end
+        entity_hash
+      end
+
+      def self.api_json(entity)
+        built_hash = build_entity_hash(entity)
+        cast_json_to_api_format(built_hash)
+      end
+
+      def self.cast_json_to_api_format(hash)
+        entity_hash = {}
+        hash.each do |key, value|
+          next if value.nil?
+
+          entity_hash[StarkInfra::Utils::Case.snake_to_camel(key)] = parse_value(value)
+        end
+        entity_hash
+      end
+
+      def self.parse_value(value)
+        return value.strftime('%Y-%m-%d') if value.is_a?(Date)
+        return value.strftime('%Y-%m-%dT%H:%M:%S+00:00') if value.is_a?(DateTime) || value.is_a?(Time)
+        return cast_json_to_api_format(value) if value.is_a?(Hash)
+        return value unless value.is_a?(Array)
+
+        list = []
+        value.each do |v|
+          list << (v.is_a?(Hash) ? cast_json_to_api_format(v) : v)
+        end
+        list
+      end
+
+      def self.from_api_json(resource_maker, json)
+        snakes = {}
+        json.each do |key, value|
+          snakes[StarkInfra::Utils::Case.camel_to_snake(key)] = value
+        end
+      
+        resource_maker.call(snakes)
+      end
+
+      def self.endpoint(resource_name)
+        kebab = StarkInfra::Utils::Case.camel_to_kebab(resource_name)
+        kebab.sub!('-log', '/log')
+        kebab.sub!('-attempt', '/attempt')
+        kebab
+      end
+
+      def self.last_name_plural(resource_name)
+        base = last_name(resource_name)
+
+        return base if base[-1].eql?('s')
+        return "#{base}s" if base[-2..-1].eql?('ey')
+        return "#{base[0...-1]}ies" if base[-1].eql?('y')
+
+        "#{base}s"
+      end
+
+      def self.last_name(resource_name)
+        StarkInfra::Utils::Case.camel_to_kebab(resource_name).split('-').last
+      end
+    end
+  end
+end

data/lib/utils/cache.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module StarkInfra
+  module Utils
+    module Cache
+      @starkinfra_public_key = nil
+      class << self; attr_accessor :starkinfra_public_key; end
+    end
+  end
+end

data/lib/utils/case.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module StarkInfra
+  module Utils
+    module Case
+      def self.camel_to_snake(camel)
+        camel.to_s.gsub(/([a-z])([A-Z\d])/, '\1_\2').downcase
+      end
+
+      def self.snake_to_camel(snake)
+        camel = snake.to_s.split('_').map(&:capitalize).join
+        camel[0] = camel[0].downcase
+        camel
+      end
+
+      def self.camel_to_kebab(camel)
+        camel_to_snake(camel).tr('_', '-')
+      end
+    end
+  end
+end