zai_payment 2.8.6 → 2.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3943f38962a68cdf4a81db8c65bf7e1662499713e2d8c07509626721c943d3eb
-  data.tar.gz: 5ecb7d95198390afa550f14f21b85c2204c6ae939f1c8b511fe7526a1022ef31
+  metadata.gz: 68b76b84ea2dd83e23dd709f8e3e13f466b6c76288231422450aa51327c53fc8
+  data.tar.gz: ff828a44dbc6769aff37a705b184a7868c3610ad7580261806e511f57ffe5c6e
 SHA512:
-  metadata.gz: 9057831bdcdecce3c5af891b543116eb3bc85627a56ebc7c29c69a2070699c4a553f74233a6a958843b4c6cf15ff2ef863235697bc059446de118148f7d5dc8a
-  data.tar.gz: 0b55cf6f3d2559d2042f12ab01023d021110ce29910c3c44928d1b55f8de00bbeb2e4d7f7cbe06a1c3fabe24624a9253d1bc3e0ea78b16acffe666c26943ead1
+  metadata.gz: 1857326fecea58e66633a177f6322aa5c6cc7d93b71e51b93d768d30d470c031783ac35a2036dbc19680850554c0ea79b24cb907b16313966a0c199b1811a3f4
+  data.tar.gz: 4125e27bc20f280f4f9a02a8b4c8d989acb8df5a7859265ac474d7412c253f80fe466f91aeee19d8a3d69b3f98de2d5c6720cdcd524c2ba34cc32714f097b4cc

data/badges/coverage.json

@@ -1 +1 @@
-{"schemaVersion": 1, "label": "coverage", "message": "95.51%", "color": "brightgreen"}
+{"schemaVersion": 1, "label": "coverage", "message": "95.57%", "color": "brightgreen"}

data/changelog.md

@@ -1,5 +1,27 @@
 ## [Released]
 
+## [2.9.0] - 2025-12-16
+
+### Added
+- **Webhook Jobs API**: Retrieve and monitor webhook delivery jobs 📋
+  - `ZaiPayment.webhooks.list_jobs(webhook_id, limit:, offset:, status:, object_id:)` - List jobs associated with a webhook
+  - `ZaiPayment.webhooks.show_job(webhook_id, job_id)` - Get details of a specific webhook job
+  - Support for pagination with `limit` (1-200) and `offset` parameters
+  - Support for filtering by `status` ('success' or 'failed')
+  - Support for filtering by `object_id`
+  - Job details include: `uuid`, `webhook_uuid`, `object_id`, `payload`, `request_responses`, `created_at`, `updated_at`
+  - Request responses include delivery attempts with `response_code`, `message`, and timestamps
+  - Validation for status parameter (must be 'success' or 'failed')
+  - Full RSpec test suite with 21 test examples
+  - Comprehensive YARD documentation with examples
+
+### Enhanced
+- **Response Class**: Added `jobs` to `RESPONSE_DATA_KEYS` for automatic data extraction
+  - `response.data` now properly extracts jobs array from list_jobs responses
+  - Consistent with other resource response handling
+
+**Full Changelog**: https://github.com/Sentia/zai-payment/compare/v2.8.6...v2.9.0
+
 ## [2.8.6] - 2025-12-12
 
 ### Fixed

data/lib/zai_payment/resources/webhook.rb

@@ -133,6 +133,62 @@ module ZaiPayment
         client.delete("/webhooks/#{webhook_id}")
       end
 
+      # List jobs associated with a webhook
+      #
+      # Retrieves an ordered and paginated list of jobs garnered from a webhook.
+      #
+      # @param webhook_id [String] the webhook ID (UUID)
+      # @param limit [Integer] number of records to retrieve (1-200, default: 10)
+      # @param offset [Integer] number of records to skip (default: 0)
+      # @param status [String] filter by status ('success', 'failed', or nil for all)
+      # @param object_id [String] filter by object_id
+      # @return [Response] the API response containing jobs array
+      #
+      # @example List all jobs for a webhook
+      #   webhooks = ZaiPayment::Resources::Webhook.new
+      #   response = webhooks.list_jobs("webhook_uuid")
+      #   response.data # => [{"id" => "...", "status" => "success", ...}, ...]
+      #
+      # @example Filter jobs by status
+      #   response = webhooks.list_jobs("webhook_uuid", status: "failed")
+      #
+      # @example Paginate through jobs
+      #   response = webhooks.list_jobs("webhook_uuid", limit: 50, offset: 100)
+      #
+      # @see https://developer.hellozai.com/reference/getjobs
+      def list_jobs(webhook_id, limit: 10, offset: 0, status: nil, object_id: nil)
+        validate_id!(webhook_id, 'webhook_id')
+        validate_job_status!(status) if status
+
+        params = {
+          limit: limit,
+          offset: offset
+        }
+        params[:status] = status if status
+        params[:object_id] = object_id if object_id
+
+        client.get("/webhooks/#{webhook_id}/jobs", params: params)
+      end
+
+      # Show a specific job associated with a webhook
+      #
+      # @param webhook_id [String] the webhook ID (UUID)
+      # @param job_id [String] the job ID
+      # @return [Response] the API response containing job details
+      #
+      # @example
+      #   webhooks = ZaiPayment::Resources::Webhook.new
+      #   response = webhooks.show_job("webhook_uuid", "job_id")
+      #   response.data # => {"id" => "job_id", "status" => "success", ...}
+      #
+      # @see https://developer.hellozai.com/reference/getjob
+      def show_job(webhook_id, job_id)
+        validate_id!(webhook_id, 'webhook_id')
+        validate_id!(job_id, 'job_id')
+
+        client.get("/webhooks/#{webhook_id}/jobs/#{job_id}")
+      end
+
       # Create a secret key for webhook signature verification
       #
       # @param secret_key [String] the secret key to use for HMAC signature generation
@@ -262,6 +318,14 @@ module ZaiPayment
         raise Errors::ValidationError, 'secret_key must be at least 32 bytes in size'
       end
 
+      def validate_job_status!(status)
+        valid_statuses = %w[success failed]
+        return if valid_statuses.include?(status)
+
+        raise Errors::ValidationError,
+              "status must be one of: #{valid_statuses.join(', ')}"
+      end
+
       def parse_signature_header(header)
         # Format: "t=1257894000,v=signature1,v=signature2"
         parts = header.split(',').map(&:strip)

data/lib/zai_payment/response.rb

@@ -6,7 +6,7 @@ module ZaiPayment
     attr_reader :status, :body, :headers, :raw_response
 
     RESPONSE_DATA_KEYS = %w[
-      webhooks users items fees transactions
+      webhooks users items fees transactions jobs
       batch_transactions batches bpay_accounts bank_accounts card_accounts
       wallet_accounts virtual_accounts disbursements pay_ids
     ].freeze

data/lib/zai_payment/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ZaiPayment
-  VERSION = '2.8.6'
+  VERSION = '2.9.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zai_payment
 version: !ruby/object:Gem::Version
-  version: 2.8.6
+  version: 2.9.0
 platform: ruby
 authors:
 - Eddy Jaga