hcp 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c1c564302b41ae3bae64611780cd75bd3547bb4b85b96e4820a868c913a1769
-  data.tar.gz: 55ea615bb079c1618cf9112d8a44673df5f143058a270453fbe519ae5ed873cb
+  metadata.gz: 90d571ad7e7872688843090321835c3f6d8b0c02a5793acee7673575d61e44f3
+  data.tar.gz: 78bd3365a5feabeced0e6a94739f091708b94722e509d2447aba4986053dd24c
 SHA512:
-  metadata.gz: 2f61c290fa12ea7acaeccc160eeeebc59a9cfb806111ab6b6a8310d8b73b678d232ab5028e86fbb85e0475b4dc0ad34b2c190f8a1845ecfdf323fb7b8dba91f9
-  data.tar.gz: 33a705767166474ecf31a1710d51a837332f554db980fef6e9ce5fad6c30ee54cafecac849a6e4e376323a77f701d9d185ebdb6ba9328bc278dad42a388d1f71
+  metadata.gz: 9dd74a5fda91a8dd80376cea9825bcd4d11db89263679ec6d21ebe382a90c14e3f4ae5a5e438ab43612f492843c26b364a40ed0a83a31389d6809b40700e80ae
+  data.tar.gz: ec5410256cfcca4f65ac92aaa0e1988eec68009ae3ae440667f71097dabc9a5e1abceb962cc7c44e3154842837130f17bddf6cf082bba7afd26f46b620fd81d5

data/CHANGELOG.md

@@ -1,5 +1,3 @@
-## [Unreleased]
+## [1.0.0] - 2026-05-15
 
-## [0.1.0] - 2026-03-24
-
-- Initial release
+- Initial release: Lead and Lead::Pipeline classes

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2026 claudiob
+Copyright (c) 2026 HouseAccount
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,39 +1,20 @@
-# Hcp
+# Housecall Pro API Ruby client
 
-TODO: Delete this and the text below, and describe your gem
+## Available methods
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/hcp`. To experiment with that code, run `bin/console` for an interactive prompt.
+Initialize and create a Lead:
 
-## Installation
+```ruby
+lead = Hcp::Lead.new key:, company_id:
+lead.create name: 'Alice', phone: '8008008000', email: 'alice@example.com',
+  address: { street: '7111 Melrose Ave', city: 'Los Angeles', state: 'CA', zip: '90046' },
+  note: 'Very interested in buying', source: 'The Lead Generator'
+````
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+Change the status of a lead in the pipeline:
 
-Install the gem and add to the application's Gemfile by executing:
-
-```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
-```
-
-If bundler is not being used to manage dependencies, install the gem by executing:
-
-```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```ruby
+pipeline = Hcp::Lead::Pipeline.new id:, key:, company_id:
+pipeline.update status_name: 'Won'
 ```
 
-## Usage
-
-TODO: Write usage instructions here
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/hcp.
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/hcp/error.rb

@@ -0,0 +1,3 @@
+module Hcp
+  Error = Class.new StandardError
+end

data/lib/hcp/lead/pipeline.rb

@@ -0,0 +1,32 @@
+module Hcp
+  class Lead::Pipeline < Resource
+    def initialize(id: nil, key:, company_id:)
+      @id = id
+      @key = key
+      @company_id = company_id
+    end
+
+    def update(status_name:)
+      status = find_status_by name: status_name
+      raise Error, "Status #{status_name} not found for lead #{@id}" unless status
+
+      payload = { resource_type: 'lead', resource_id: @id, status_id: status['id'] }.to_json
+      Net::HTTP.put uri, payload, headers
+    rescue Errno::ECONNREFUSED => error
+      raise Error, error
+    end
+
+  private
+
+    def find_status_by(name:)
+      body = JSON Net::HTTP.get(uri, headers)
+      body['statuses'].find { |status| status['name'] == name } || unknown_status(name: name)
+    end
+
+    def unknown_status(name:)
+      raise Error, "Status #{name} not found for lead #{@id}"
+    end
+
+    def uri = URI 'https://api.housecallpro.com/pipeline/statuses?resource_type=lead'
+  end
+end

data/lib/hcp/lead.rb

@@ -0,0 +1,35 @@
+module Hcp
+  class Lead < Resource
+    attr_reader :customer_id
+
+    def initialize(id: nil, customer_id: nil, key:, company_id:)
+      @id = id
+      @key = key
+      @company_id = company_id
+      @customer_id = customer_id
+    end
+
+    def create(params = {})
+      body = JSON Net::HTTP.post(uri, lead_for(params).to_json, headers).body
+      @id, @customer_id = body['id'], body.dig('customer', 'id')
+    rescue Errno::ECONNREFUSED => error
+      raise Error, error
+    end
+
+    def lead_for(params = {})
+      {
+        customer: customer_for(params), address: params[:address],
+        lead_source: params[:source], note: params[:note]
+      }.compact_blank
+    end
+
+    def customer_for(params = {})
+      {
+        first_name: params[:name], email: params[:email],
+        mobile_number: params[:phone], lead_source: params[:source],
+      }.compact_blank
+    end
+
+    def uri = URI 'https://api.housecallpro.com/leads'
+  end
+end

data/lib/hcp/resource.rb

@@ -0,0 +1,15 @@
+module Hcp
+  class Resource
+    attr_reader :id
+
+  private
+
+    def headers
+      {
+        'Authorization' => "Token #{@key}",
+        'Content-Type' => 'application/json',
+        'X-Company-Id' => @company_id,
+      }.compact
+    end
+  end
+end

data/lib/hcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hcp
-  VERSION = "0.1.0"
+  VERSION = '1.0.0'
 end

data/lib/hcp.rb

@@ -1,8 +1,9 @@
 # frozen_string_literal: true
 
-require_relative "hcp/version"
+require 'json'
+require 'net/http'
 
-module Hcp
-  class Error < StandardError; end
-  # Your code goes here...
-end
+require 'hcp/error'
+require 'hcp/resource'
+require 'hcp/lead'
+require 'hcp/lead/pipeline'

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: hcp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
-- claudiob
+- Claudio Baccigalupo
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -19,10 +19,12 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- Rakefile
 - lib/hcp.rb
+- lib/hcp/error.rb
+- lib/hcp/lead.rb
+- lib/hcp/lead/pipeline.rb
+- lib/hcp/resource.rb
 - lib/hcp/version.rb
-- sig/hcp.rbs
 homepage: https://github.com/HouseAccountEng/hcp
 licenses:
 - MIT

data/Rakefile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
-
-task default: :spec

data/sig/hcp.rbs

@@ -1,4 +0,0 @@
-module Hcp
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end