freshbooks-cli 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e9f2e80e5c692c3e2f848dc206858d680c0061166e8a013b16e877830b70db1
-  data.tar.gz: 8e52c8bc022ee719e91b8d4b35848c497d0ef5e8795e3e980e90fd773add1b76
+  metadata.gz: 84f4c3c33549e8e6f23749a6597fe394d6d94b248c54453810c4bd198b3e4294
+  data.tar.gz: 76d88cb16bf1d4b9298869c4b0a9db068157cbd6e068c851e27a834516b5baa8
 SHA512:
-  metadata.gz: 888e34a5ac7493d2b5ad9974094c90caf7f1151b711f717bc8ed41adf19c487cd446bbe5545e30cb7cddec9c16f60b2cbf9a6a38e7781f7b1921d47726e46542
-  data.tar.gz: 06ac47c6e320242bb088b90d8e55e3452e71ae72e5eb42fb0a69c8f1ca620e0564a10a5a2c0cd926c120b942db326511b75f57b4d2b8e26725f541ae20d33a7d
+  metadata.gz: 0cba9865b5c7b5e1e2e2b11590be7044803ca4afbb0a8eeba1d3136a84fc5ebaadfd542bf531d3d37073274936f30794dad006348a09bc4fc424a79ef993fc73
+  data.tar.gz: 8d11babdd9b8f3406a664d13f89cca6c5fd915b8154044bfe9dddb3fea2b620ac99d8c0b774a8ffa81c5d32c6e9dfb4521ffaa728dc1f3b68d122e645c21de3d

data/bin/fb

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "fb"
+require "freshbooks"
 
-FB::Cli.start(ARGV)
+FreshBooks::CLI::Commands.start(ARGV)

data/lib/freshbooks/api.rb

@@ -0,0 +1,325 @@
+# frozen_string_literal: true
+
+require "httparty"
+require "json"
+
+module FreshBooks
+  module CLI
+    class Api
+      BASE = "https://api.freshbooks.com"
+
+      class << self
+        def headers
+          token = Auth.valid_access_token
+          {
+            "Authorization" => "Bearer #{token}",
+            "Content-Type" => "application/json"
+          }
+        end
+
+        def config
+          @config = nil
+          @config = Auth.require_config
+        end
+
+        def business_id
+          c = config
+          unless c["business_id"]
+            c = Auth.require_business(c)
+          end
+          c["business_id"]
+        end
+
+        def account_id
+          c = config
+          unless c["account_id"]
+            c = Auth.require_business(c)
+          end
+          c["account_id"]
+        end
+
+        # --- Paginated fetch ---
+
+        def fetch_all_pages(url, result_key, params: {})
+          return [] if Thread.current[:fb_dry_run]
+
+          page = 1
+          all_items = []
+
+          loop do
+            response = HTTParty.get(url, {
+              headers: headers,
+              query: params.merge(page: page, per_page: 100)
+            })
+
+            unless response.success?
+              body = response.parsed_response
+              msg = extract_error(body) || response.body
+              abort("API error: #{msg}")
+            end
+
+            data = response.parsed_response
+            items = dig_results(data, result_key)
+            break if items.nil? || items.empty?
+
+            all_items.concat(items)
+
+            meta = dig_meta(data)
+            break if meta.nil?
+            break if page >= meta["pages"].to_i
+
+            page += 1
+          end
+
+          all_items
+        end
+
+        # --- Cache helpers ---
+
+        def cache_fresh?
+          cache = Auth.load_cache
+          cache["updated_at"] && (Time.now.to_i - cache["updated_at"]) < 600
+        end
+
+        def cached_data(key)
+          return Auth.load_cache[key] if Thread.current[:fb_dry_run]
+
+          cache = Auth.load_cache
+          return nil unless cache["updated_at"] && (Time.now.to_i - cache["updated_at"]) < 600
+          cache[key]
+        end
+
+        def update_cache(key, data)
+          cache = Auth.load_cache
+          cache["updated_at"] = Time.now.to_i
+          cache[key] = data
+          Auth.save_cache(cache)
+        end
+
+        # --- Clients ---
+
+        def fetch_clients(force: false)
+          unless force
+            cached = cached_data("clients_data")
+            return cached if cached
+          end
+
+          url = "#{BASE}/accounting/account/#{account_id}/users/clients"
+          results = fetch_all_pages(url, "clients")
+          update_cache("clients_data", results)
+          results
+        end
+
+        # --- Projects ---
+
+        def fetch_projects(force: false)
+          unless force
+            cached = cached_data("projects_data")
+            return cached if cached
+          end
+
+          url = "#{BASE}/projects/business/#{business_id}/projects"
+          results = fetch_all_pages(url, "projects")
+          update_cache("projects_data", results)
+          results
+        end
+
+        def fetch_projects_for_client(client_id)
+          all = fetch_projects
+          all.select { |p| p["client_id"].to_i == client_id.to_i }
+        end
+
+        # --- Services ---
+
+        def fetch_services(force: false)
+          return (Auth.load_cache["services_data"] || []) if Thread.current[:fb_dry_run]
+
+          unless force
+            cached = cached_data("services_data")
+            return cached if cached
+          end
+
+          url = "#{BASE}/comments/business/#{business_id}/services"
+          response = HTTParty.get(url, { headers: headers })
+
+          unless response.success?
+            body = response.parsed_response
+            msg = extract_error(body) || response.body
+            abort("API error: #{msg}")
+          end
+
+          data = response.parsed_response
+          services_hash = data.dig("result", "services") || {}
+          results = services_hash.values
+          update_cache("services_data", results)
+          results
+        end
+
+        # --- Time Entries ---
+
+        def fetch_time_entries(started_from: nil, started_to: nil)
+          url = "#{BASE}/timetracking/business/#{business_id}/time_entries"
+          params = {}
+          params["started_from"] = "#{started_from}T00:00:00Z" if started_from
+          params["started_to"] = "#{started_to}T23:59:59Z" if started_to
+          fetch_all_pages(url, "time_entries", params: params)
+        end
+
+        def fetch_time_entry(entry_id)
+          url = "#{BASE}/timetracking/business/#{business_id}/time_entries/#{entry_id}"
+          response = HTTParty.get(url, { headers: headers })
+
+          unless response.success?
+            body = response.parsed_response
+            msg = extract_error(body) || response.body
+            abort("API error: #{msg}")
+          end
+
+          data = response.parsed_response
+          data.dig("result", "time_entry") || data.dig("time_entry")
+        end
+
+        def create_time_entry(entry)
+          if Thread.current[:fb_dry_run]
+            return {
+              "_dry_run" => { "simulated" => true, "payload_sent" => entry },
+              "result" => { "time_entry" => entry.merge("id" => 0) }
+            }
+          end
+
+          url = "#{BASE}/timetracking/business/#{business_id}/time_entries"
+          body = { time_entry: entry }
+
+          response = HTTParty.post(url, {
+            headers: headers,
+            body: body.to_json
+          })
+
+          unless response.success?
+            body = response.parsed_response
+            msg = extract_error(body) || response.body
+            abort("API error: #{msg}")
+          end
+
+          response.parsed_response
+        end
+
+        def update_time_entry(entry_id, fields)
+          if Thread.current[:fb_dry_run]
+            return {
+              "_dry_run" => { "simulated" => true, "payload_sent" => fields },
+              "result" => { "time_entry" => fields.merge("id" => entry_id) }
+            }
+          end
+
+          url = "#{BASE}/timetracking/business/#{business_id}/time_entries/#{entry_id}"
+          body = { time_entry: fields }
+
+          response = HTTParty.put(url, {
+            headers: headers,
+            body: body.to_json
+          })
+
+          unless response.success?
+            body = response.parsed_response
+            msg = extract_error(body) || response.body
+            abort("API error: #{msg}")
+          end
+
+          response.parsed_response
+        end
+
+        def delete_time_entry(entry_id)
+          return true if Thread.current[:fb_dry_run]
+
+          url = "#{BASE}/timetracking/business/#{business_id}/time_entries/#{entry_id}"
+
+          response = HTTParty.delete(url, { headers: headers })
+
+          unless response.success?
+            body = response.parsed_response
+            msg = extract_error(body) || response.body
+            abort("API error: #{msg}")
+          end
+
+          true
+        end
+
+        # --- Name Resolution (for entries display) ---
+
+        def build_name_maps
+          cache = Auth.load_cache
+          now = Time.now.to_i
+
+          if cache["updated_at"] && (now - cache["updated_at"]) < 600 &&
+             cache["clients"] && !cache["clients"].empty?
+            return {
+              clients: (cache["clients"] || {}),
+              projects: (cache["projects"] || {}),
+              services: (cache["services"] || {})
+            }
+          end
+
+          clients = fetch_clients(force: true)
+          projects = fetch_projects(force: true)
+          services = fetch_services(force: true)
+
+          client_map = {}
+          clients.each do |c|
+            name = c["organization"]
+            name = "#{c["fname"]} #{c["lname"]}" if name.nil? || name.empty?
+            client_map[c["id"].to_s] = name
+          end
+
+          project_map = {}
+          projects.each do |p|
+            project_map[p["id"].to_s] = p["title"]
+          end
+
+          service_map = {}
+          services.each do |s|
+            service_map[s["id"].to_s] = s["name"]
+          end
+
+          # Also collect services embedded in projects
+          projects.each do |p|
+            (p["services"] || []).each do |s|
+              service_map[s["id"].to_s] ||= s["name"]
+            end
+          end
+
+          cache = Auth.load_cache
+          cache["updated_at"] = now
+          cache["clients"] = client_map
+          cache["projects"] = project_map
+          cache["services"] = service_map
+          Auth.save_cache(cache)
+
+          { clients: client_map, projects: project_map, services: service_map }
+        end
+
+        private
+
+        def extract_error(body)
+          return nil unless body.is_a?(Hash)
+          body["error_description"] ||
+            body.dig("response", "errors", 0, "message") ||
+            body.dig("error") ||
+            body.dig("message")
+        end
+
+        def dig_results(data, key)
+          data.dig("result", key) ||
+            data.dig("response", "result", key) ||
+            data.dig(key)
+        end
+
+        def dig_meta(data)
+          data.dig("result", "meta") ||
+            data.dig("response", "result", "meta") ||
+            data.dig("meta")
+        end
+      end
+    end   # closes class Api
+  end     # closes module CLI
+end       # closes module FreshBooks