moco-ruby 0.1.2 → 1.0.0

data/lib/moco/entities/web_hook.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Represents a MOCO webhook
+  # Provides methods for webhook-specific operations
+  class WebHook < BaseEntity
+    # Override entity_path to match API path
+    def self.entity_path
+      "account/web_hooks"
+    end
+
+    # Instance methods for webhook-specific operations
+    def enable
+      client.put("account/web_hooks/#{id}/enable")
+      self
+    end
+
+    def disable
+      client.put("account/web_hooks/#{id}/disable")
+      self
+    end
+
+    def to_s
+      "#{target} - #{url}"
+    end
+  end
+end

data/lib/moco/entities.rb

@@ -4,6 +4,7 @@ require_relative "helpers"
 
 module MOCO
   # Base entity class others inherit from, providing comparison, to_h, to_json
+  # @deprecated Use MOCO::BaseEntity from entities/base_entity.rb instead
   class BaseEntity
     def eql?(other)
       return false unless other.is_a? self.class
@@ -28,7 +29,6 @@ module MOCO
       hash
     end
 
-    # rubocop:disable Metrics/MethodLength
     def to_json(*arg)
       to_h do |k, v|
         if v.is_a? Hash
@@ -43,9 +43,9 @@ module MOCO
       end.to_h.to_json(arg)
     end
   end
-  # rubocop:enable Metrics/MethodLength
 
   # https://hundertzehn.github.io/mocoapp-api-docs/sections/projects.html
+  # @deprecated Use MOCO::Project from entities/project.rb instead
   class Project < BaseEntity
     attr_accessor :id, :active, :name, :customer, :tasks
 
@@ -55,6 +55,7 @@ module MOCO
   end
 
   # https://hundertzehn.github.io/mocoapp-api-docs/sections/project_tasks.html
+  # @deprecated Use MOCO::Task from entities/task.rb instead
   class Task < BaseEntity
     attr_accessor :id, :active, :name, :project_id, :billable
 
@@ -64,22 +65,28 @@ module MOCO
   end
 
   # https://hundertzehn.github.io/mocoapp-api-docs/sections/activities.html
+  # @deprecated Use MOCO::Activity from entities/activity.rb instead
   class Activity < BaseEntity
     attr_accessor :id, :active, :date, :description, :project, :task, :seconds, :hours, :billable, :billed, :user,
                   :customer, :tag
 
     def to_s
-      "#{date} - #{Helpers.decimal_hours_to_civil(hours)}h (#{seconds}s) - #{project&.name} - #{task&.name}#{description.empty? ? "" : " (#{description})"} " \
-        "(#{%i[billable billed].map { |x| (send(x) ? "" : "not ") + x.to_s }.join(", ")})"
+      description_part = description.empty? ? "" : " (#{description})"
+      status_part = "(#{%i[billable billed].map { |x| (send(x) ? "" : "not ") + x.to_s }.join(", ")})"
+
+      "#{date} - #{Helpers.decimal_hours_to_civil(hours)}h (#{seconds}s) - " \
+        "#{project&.name} - #{task&.name}#{description_part} #{status_part}"
     end
   end
 
   # https://hundertzehn.github.io/mocoapp-api-docs/sections/companies.html
+  # @deprecated Use MOCO::Company from entities/company.rb instead
   class Customer < BaseEntity
     attr_accessor :id, :name
   end
 
   # https://hundertzehn.github.io/mocoapp-api-docs/sections/users.html
+  # @deprecated Use MOCO::User from entities/user.rb instead
   class User < BaseEntity
     attr_accessor :id, :firstname, :lastname
   end

data/lib/moco/entity_collection.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative "collection_proxy"
+
+module MOCO
+  # Provides high-level collection operations for MOCO entities
+  class EntityCollection
+    include Enumerable
+    attr_reader :client, :path, :entity_class_name
+
+    def initialize(client, path, entity_class_name)
+      @client = client
+      @path = path
+      @entity_class_name = entity_class_name
+    end
+
+    def all
+      collection.all
+    end
+
+    def find(id)
+      collection.find(id)
+    end
+
+    def where(filters = {})
+      collection.where(filters)
+    end
+
+    def create(attributes)
+      collection.create(attributes)
+    end
+
+    def each(&)
+      collection.each(&)
+    end
+
+    def first
+      all.first
+    end
+
+    def count
+      all.count
+    end
+
+    def update(id, attributes)
+      collection.update(id, attributes)
+    end
+
+    def delete(id)
+      collection.delete(id)
+    end
+
+    private
+
+    def collection
+      @collection ||= CollectionProxy.new(client, path, entity_class_name)
+    end
+  end
+end

data/lib/moco/helpers.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module MOCO
+  # Utility class with helper methods for the MOCO API
   class Helpers
     def self.decimal_hours_to_civil(decimal_hours)
       hours = decimal_hours.floor

data/lib/moco/nested_collection_proxy.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Provides ActiveRecord-style query interface for nested MOCO entities
+  # For example, project.tasks is a nested collection of tasks under a project
+  class NestedCollectionProxy < CollectionProxy
+    attr_reader :parent, :records
+
+    def initialize(client, parent, path_or_entity_name, entity_class_name)
+      @parent = parent
+      super(client, path_or_entity_name, entity_class_name)
+    end
+
+    # Override determine_base_path to include the parent's path
+    # For nested resources, we ignore any custom entity_path and just use simple pluralization
+    def determine_base_path(path_or_entity_name)
+      parent_type = ActiveSupport::Inflector.underscore(parent.class.name.split("::").last)
+      # Use simple tableized name, not entity_path (which might include 'projects/' prefix)
+      nested_path = ActiveSupport::Inflector.tableize(path_or_entity_name.to_s)
+      "#{parent_type.pluralize}/#{parent.id}/#{nested_path}"
+    end
+
+    # Create a new entity in this nested collection
+    def create(attributes)
+      klass = entity_class
+      return nil unless klass && klass <= MOCO::BaseEntity
+
+      klass.new(client, client.post(@base_path, attributes))
+    end
+
+    # Delete all entities in this nested collection
+    def destroy_all
+      client.delete("#{@base_path}/destroy_all")
+      true
+    rescue StandardError => e
+      warn "Warning: Failed to destroy all entities in #{@base_path}: #{e.message}"
+      false
+    end
+
+    # Make these methods public so they can be accessed by Project#tasks
+    public :load_records, :loaded?
+  end
+end