ashby 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e855315529a1db2046338905389213fd31d25a5b06cd108da13dcaf21d1ffda
-  data.tar.gz: 21cef7834c42bda68bd5403003c631ccf5f6ba78d8ff6481390bd550ba0cf757
+  metadata.gz: '09a8af897eeee672d698d855e5f6ac0f59d73d3cce0a24390cb76e5a549b5327'
+  data.tar.gz: '0385e3c248c17ca0e3269bcf68388109d19c8b4e2cd6ef62f7da4ea064d97d71'
 SHA512:
-  metadata.gz: 256f5a827351f307416f34df1c49968459bcfa6a892d739155521784d78a75ad1dacb300de062d588143ac5ffac6347fe29b516168bf0434ca145528886b48c0
-  data.tar.gz: e1eedbdf08c2fcc648c448a4e54e00374953d7c1c0bd36d41960f7d0d8fcdf84c780a470fff5287d23bd79095d89ffdbefaff520050db2e30e90be2ed5325854
+  metadata.gz: 792cd2180f6a00004eca115b3bc2754aa33a0a0459668d036e552505ec93521fcb243f379d0d145fc9662f1e7fcc100a961e9a03d812f889731b903d1c44ac09
+  data.tar.gz: 351e266d26c5768264f56d16a067684ad50914ef882df4877ea22847f8866e3f3d76cc9c4f3e77a324e1a193f5ad90cce07a14b45492e5b4ed4d30612412b433

data/CHANGELOG.md

@@ -1,4 +1,11 @@
-## [Unreleased]
+# Changelog
+
+## [0.1.4] - 2025-12-08
+
+### Added
+
+- `Ashby::Reports.synchronous` - Retrieve report data synchronously with 30-second timeout
+- `Ashby::Reports.generate` - Generate reports asynchronously with two-step polling process
 
 ## [0.1.0] - 2025-05-30
 

data/lib/ashby/reports.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Ashby
+  # Ashby::Reports provides access to report-related functionality in the Ashby API.
+  #
+  # Supports running reports synchronously and generating them asynchronously.
+  # The synchronous endpoint has a 30-second timeout; for longer-running reports, use the
+  # asynchronous generate method.
+  #
+  # Example:
+  #   Ashby::Reports.synchronous(id: 'report_abc123')
+  #
+  #   # Async generation - two-step process
+  #   result = Ashby::Reports.generate(id: 'report_abc123')
+  #   request_id = result['requestId']
+  #   # Poll until complete
+  #   result = Ashby::Reports.generate(id: 'report_abc123', request_id: request_id)
+  #
+  class Reports < Client
+    # Retrieves report data synchronously (30 second timeout)
+    # If a report times out, use generate instead
+    def self.synchronous(id: nil)
+      raise ArgumentError, 'Report ID is required' if id.to_s.strip.empty?
+
+      payload = { reportId: id }
+      response = post('report.synchronous', payload)
+      response['results']
+    end
+
+    # Generates a report asynchronously
+    # Two-step process:
+    # 1. Call with only report_id to start generation (returns request_id)
+    # 2. Poll with both report_id and request_id until status is 'complete' or 'failed'
+    def self.generate(id: nil, request_id: nil)
+      raise ArgumentError, 'Report ID is required' if id.to_s.strip.empty?
+
+      payload = { reportId: id }
+      payload[:requestId] = request_id unless request_id.to_s.strip.empty?
+
+      response = post('report.generate', payload)
+      response['results']
+    end
+  end
+end

data/lib/ashby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ashby
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

data/lib/ashby.rb

@@ -19,6 +19,7 @@ require_relative 'ashby/custom_fields'
 require_relative 'ashby/feedback'
 require_relative 'ashby/postings'
 require_relative 'ashby/job_boards'
+require_relative 'ashby/reports'
 
 # This module handles integration with Ashby's API
 # for recruitment and hiring processes

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ashby
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Lien
@@ -84,6 +84,7 @@ files:
 - lib/ashby/offers.rb
 - lib/ashby/openings.rb
 - lib/ashby/postings.rb
+- lib/ashby/reports.rb
 - lib/ashby/users.rb
 - lib/ashby/version.rb
 - sig/.DS_Store
@@ -110,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby wrapper for Ashby's API.
 test_files: []