ashby 0.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0e855315529a1db2046338905389213fd31d25a5b06cd108da13dcaf21d1ffda
+  data.tar.gz: 21cef7834c42bda68bd5403003c631ccf5f6ba78d8ff6481390bd550ba0cf757
+SHA512:
+  metadata.gz: 256f5a827351f307416f34df1c49968459bcfa6a892d739155521784d78a75ad1dacb300de062d588143ac5ffac6347fe29b516168bf0434ca145528886b48c0
+  data.tar.gz: e1eedbdf08c2fcc648c448a4e54e00374953d7c1c0bd36d41960f7d0d8fcdf84c780a470fff5287d23bd79095d89ffdbefaff520050db2e30e90be2ed5325854

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/ashby.iml

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.3, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.6.8, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="date (v3.4.1, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="diff-lcs (v1.6.2, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="domain_name (v0.6.20240107, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="erb (v5.0.1, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="http-accept (v1.7.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="http-cookie (v1.0.8, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="io-console (v0.8.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="irb (v1.15.2, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="json (v2.12.2, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="language_server-protocol (v3.17.0.5, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="lint_roller (v1.1.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="logger (v1.7.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="mime-types (v3.7.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="mime-types-data (v3.2025.0527, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="netrc (v0.11.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.27.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parser (v3.3.8.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="pp (v0.6.2, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="prettyprint (v0.2.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="prism (v1.4.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="psych (v5.2.6, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="racc (v1.8.1, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.1.1, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v13.3.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rdoc (v6.14.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="regexp_parser (v2.10.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="reline (v0.6.1, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rest-client (v2.1.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec (v3.13.1, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-core (v3.13.4, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-expectations (v3.13.5, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-mocks (v3.13.5, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-support (v3.13.4, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop (v1.75.8, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-ast (v1.44.1, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.13.0, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="stringio (v3.1.7, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v3.1.4, rbenv: 3.2.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-emoji (v4.0.4, rbenv: 3.2.3) [gem]" level="application" />
+  </component>
+  <component name="RakeTasksCache-v2">
+    <option name="myRootTask">
+      <RakeTaskImpl id="rake">
+        <subtasks>
+          <RakeTaskImpl description="Build ashby-0.1.1.gem into the pkg directory" fullCommand="build" id="build" />
+          <RakeTaskImpl id="build">
+            <subtasks>
+              <RakeTaskImpl description="Generate SHA512 checksum of ashby-0.1.1.gem into the checksums directory" fullCommand="build:checksum" id="checksum" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
+          <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
+          <RakeTaskImpl description="Build and install ashby-0.1.1.gem into system gems" fullCommand="install" id="install" />
+          <RakeTaskImpl id="install">
+            <subtasks>
+              <RakeTaskImpl description="Build and install ashby-0.1.1.gem into system gems without network access" fullCommand="install:local" id="local" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Create tag v0.1.1 and build and push ashby-0.1.1.gem to TODO: Set to your gem server 'https://example.com'" fullCommand="release[remote]" id="release[remote]" />
+          <RakeTaskImpl description="Run RuboCop" fullCommand="rubocop" id="rubocop" />
+          <RakeTaskImpl id="rubocop">
+            <subtasks>
+              <RakeTaskImpl description="Autocorrect RuboCop offenses (only when it's safe)" fullCommand="rubocop:autocorrect" id="autocorrect" />
+              <RakeTaskImpl description="Autocorrect RuboCop offenses (safe and unsafe)" fullCommand="rubocop:autocorrect_all" id="autocorrect_all" />
+              <RakeTaskImpl description="" fullCommand="rubocop:auto_correct" id="auto_correct" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Run RSpec code examples" fullCommand="spec" id="spec" />
+          <RakeTaskImpl description="" fullCommand="default" id="default" />
+          <RakeTaskImpl description="" fullCommand="release" id="release" />
+          <RakeTaskImpl id="release">
+            <subtasks>
+              <RakeTaskImpl description="" fullCommand="release:guard_clean" id="guard_clean" />
+              <RakeTaskImpl description="" fullCommand="release:rubygem_push" id="rubygem_push" />
+              <RakeTaskImpl description="" fullCommand="release:source_control_push" id="source_control_push" />
+            </subtasks>
+          </RakeTaskImpl>
+        </subtasks>
+      </RakeTaskImpl>
+    </option>
+  </component>
+</module>

data/.idea/misc.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="rbenv: 3.2.3" project-jdk-type="RUBY_SDK" />
+</project>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/ashby.iml" filepath="$PROJECT_DIR$/.idea/ashby.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,8 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  NewCops: enable
+
+plugins:
+  - rubocop-rake
+  - rubocop-rspec

data/.rubocop_todo.yml

@@ -0,0 +1,27 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-09-08 15:31:51 UTC using RuboCop version 1.75.8.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 11
+
+# Offense count: 1
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/ashby/job_boards.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 121

data/.vscode/settings.json

@@ -0,0 +1 @@
+{}

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-05-30
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Lien Van Den Steen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,50 @@
+# Ashby
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add ashby
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install ashby
+```
+
+## Usage
+
+First you will have to confige the gem. You need to setup an API token on Ashby. Once you've retrieved that, you are ready:
+
+```ruby
+Ashby.configure do |config|
+  config.api_token = ENV.fetch('ASHBY_API_TOKEN', nil)
+end
+```
+
+Then once you have the client setup, you can call the API. Some examples:
+
+```ruby
+Ashby::JobBoards.all
+Ashby::Applications.find_by_id(application_id)
+```
+
+## 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/lienvdsteen/ashby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/lienvdsteen/ashby/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Ashby project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/lienvdsteen/ashby/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/lib/ashby/applications.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Ashby
+  # Ashby::Applications provides access to job application-related operations via the Ashby API.
+  #
+  # Supported functionality includes:
+  #   - Retrieving a paginated list of all applications
+  #   - Fetching a specific application by its ID
+  #
+  # Example usage:
+  #   Ashby::Applications.all
+  #   Ashby::Applications.find_by_id(id: 'app_abc123')
+  #
+  class Applications < Client
+    # Fetches all openings with pagination support
+    def self.all(payload = {})
+      paginated_post('application.list', payload)
+    end
+
+    # Finds an opening by its Ashby ID
+    def self.find_by_id(id: nil, expand: '')
+      raise ArgumentError, 'Application ID is required' if id.to_s.strip.empty?
+
+      payload = {
+        applicationId: id,
+        expand: expand.strip.empty? ? [] : [expand]
+      }
+      response = post('application.info', payload)
+      response['results']
+    end
+  end
+end

data/lib/ashby/candidates.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Ashby
+  # Ashby::Candidates provides access to candidate-related functionality in the Ashby API.
+  #
+  # Includes support for:
+  #   - Fetching all candidates (with pagination)
+  #   - Searching by email or name
+  #   - Looking up by ID
+  #   - Adding notes to candidate profiles in plain text or HTML
+  #
+  # Example:
+  #   Ashby::Candidates.all
+  #   Ashby::Candidates.find(email: 'jane@company.com')
+  #   Ashby::Candidates.find_by_id(id: 'cand_abc123')
+  #
+  #   client = Ashby::Candidates.new
+  #   client.create_candidate_note('cand_abc123', 'Reached out via email.')
+  #   client.create_formatted_candidate_note('cand_abc123', title: 'Initial Contact',
+  #     content: 'Spoke with Jane over Zoom.')
+  #
+  class Candidates < Client
+    # Fetches all candidates with pagination support
+    def self.all
+      paginated_post('candidate.list')
+    end
+
+    # Finds a candidate by their email or name
+    def self.find(email: nil, name: nil)
+      payload = {}
+      payload[:email] = email if email
+      payload[:name] = name if name
+
+      raise ArgumentError, 'You must provide at least an email or a name' if payload.empty?
+
+      response = post('candidate.search', payload)
+      response['results']
+    end
+
+    # Finds a candidate by their Ashby ID
+    def self.find_by_id(id: nil)
+      raise ArgumentError, 'Candidate ID is required' if id.to_s.strip.empty?
+
+      payload = { id: id }
+      response = post('candidate.info', payload)
+      response['results']
+    end
+
+    # Creates a note on a candidates profile
+    def self.create_candidate_note(candidate_id, note_content, send_notifications: false)
+      payload = {
+        candidateId: candidate_id,
+        note: note_content,
+        sendNotifications: send_notifications
+      }
+
+      response = post('candidate.createNote', payload)
+      raise "Failed to create note: #{response['error']}" unless response['success']
+
+      response['results']
+    end
+  end
+end

data/lib/ashby/client.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'rest-client'
+require 'json'
+
+module Ashby
+  # Ashby::Client is a low-level internal class that provides HTTP communication
+  # with the Ashby API.
+  #
+  # It defines base `post` and `paginated_post` methods for making JSON API calls,
+  # managing authentication, and handling paginated responses.
+  #
+  # This class is extended by endpoint-specific service classes (e.g., Jobs, Offers).
+  #
+  # Example usage:
+  #   Ashby::Client.post('job.info', { id: 'job_abc123' })
+  #   Ashby::Client.paginated_post('job.list')
+  #
+  # Note:
+  #   Ensure `Ashby.api_token` is set before making requests.
+  #
+  # TODO:
+  #   Consider implementing syncToken support for incremental pagination.
+  #
+  class Client
+    API_URL = 'https://api.ashbyhq.com'
+
+    def self.post(path, payload = {})
+      url = build_url(path, {})
+      response = RestClient.post(url, payload.to_json, headers.merge({ content_type: :json }))
+      JSON.parse(response.body)
+    end
+
+    def self.paginated_post(path, payload = {}, limit: 100) # rubocop:disable Metrics/MethodLength
+      all_results = []
+      cursor = nil
+
+      loop do
+        paginated_payload = payload.dup
+        paginated_payload[:limit] = limit
+        paginated_payload[:cursor] = cursor if cursor
+
+        response = post(path, paginated_payload)
+
+        page_results = response['data'] || response['results'] || response
+
+        if page_results.is_a?(Array)
+          all_results.concat(page_results)
+        else
+          all_results << page_results
+        end
+
+        break unless response['moreDataAvailable'] && response['nextCursor']
+
+        cursor = response['nextCursor']
+      end
+
+      all_results
+    end
+
+    def self.build_url(path, params)
+      url = "#{API_URL}/#{path}"
+      url += "?#{URI.encode_www_form(params)}" unless params.empty?
+      url
+    end
+
+    def self.headers
+      token = "#{Ashby.api_token}:"
+      {
+        Accept: 'application/json',
+        Authorization: "Basic #{Base64.strict_encode64(token)}"
+      }
+    end
+  end
+end

data/lib/ashby/close_reasons.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Ashby
+  # Ashby::CloseReasons provides access to close reason related functionality in the Ashby API.
+  #
+  # Includes support for:
+  #   - Fetching all close reasons (with pagination)
+  #
+  # Example:
+  #   Ashby::CloseReasons.all
+  #
+  class CloseReasons < Client
+    # Fetches all openings with pagination support
+    def self.all
+      response = post('closeReason.list')
+      response['results']
+    end
+  end
+end

data/lib/ashby/configuration.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Ashby
+  # Ashby::Configuration manages global settings for the Ashby API client.
+  #
+  # This module is intended to be extended by a class or module that needs
+  # to hold configuration settings such as the API token.
+  #
+  # Example:
+  #   Ashby::Configuration.configure do |config|
+  #     config.api_token = 'your-token'
+  #   end
+  #
+  #   Ashby::Configuration.config
+  #   # => { api_token: 'your-token' }
+  #
+  module Configuration
+    VALID_OPTIONS_KEYS = %i[api_token].freeze
+    attr_accessor(*VALID_OPTIONS_KEYS)
+
+    # Sets all configuration options to their default values
+    # when this module is extended.
+    def self.extended(base)
+      base.reset
+    end
+
+    def configure
+      yield self
+    end
+
+    def config
+      VALID_OPTIONS_KEYS.inject({}) do |option, key|
+        option.merge!(key => send(key))
+      end
+    end
+
+    # Resets all configuration options to the defaults.
+    def reset
+      self.api_token = nil
+    end
+  end
+end