tango-api-client 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aaca119882836f7c7ce028b229ef0bab2e57766b388aaab5825a6e8a03b336c1
-  data.tar.gz: c32dd9d3e4ae82a78731d7408ade3a22a08f69e9c39b558b51700ca141d9d80b
+  metadata.gz: f7475c292cfcb29d85404d80d86cb94f47c4d0497dcfd97743366be0af176933
+  data.tar.gz: 69d61b9a8d860fd5734557d61aec61ae8d969634803c3a97e87f23db9ead35e1
 SHA512:
-  metadata.gz: 7ed6160b4286d4628a79d961581bc6165a01f9a4446255a65663e0ff27a5145138da42b958b04bba2209168a103c74df4f29d3bdc930a02bb6f74202578414cb
-  data.tar.gz: b2a464703e63b4a5869a3c61f0d670aafb906b757c020a58abd62935dbaea23b1331be6d342830ca439dc9018fe0e990e477e4730a3c2a74451091c57943784d
+  metadata.gz: 1243790a92ce6dba4870e506fb86e00a9436bf7c9c6e206e6d7d908b7011a0a06139ee0ba2decd3f6d0b4dd1341bd856484b66c7ad252886b88f091cb0faebc3
+  data.tar.gz: 6205cc363c7e1d2ef985b31fedb377a53c242d9d7339568d1bb5480be0aa8aecfc249fb1b71dc3b05efc4d208ef8e65311c405cb40244f31b0029404fa2262be

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 ## [Unreleased]
 - Nothing yet.
 
+## [0.2.0] - 2026-11-09
+- Add Webhooks resource for subscription management: `create`, `list`, `get`, `update`, `delete`, `renew`
+- Add webhook event history and redelivery: `events` (cursor paging, revision range) and `replay` (`fromRevision`/`toRevision` query params)
+- Add `test` to trigger Tango's test deliveries (`ConnectivityTest`, or an event type such as `ItemAvailability` in the sandbox)
+- `Resources::Base#post_without_body` for POST action endpoints that take only path and query parameters
+
+## [0.1.2] - 2025-11-12
+- Add Brand Categories resource: `get` method for `/brandCategories` endpoint
+
+## [0.1.1] - 2025-11-12
+- (Version already published)
+
 ## [0.1.0] - 2025-11-07
 - Initial release
 - Basic and OAuth2 auth strategies

data/README.md

@@ -115,6 +115,19 @@ client.orders.create(
 
 # Resend with Idempotency-Key (prevents duplicate resends)
 client.orders.resend('ORDER-123', idempotency_key: idempotency)
+
+# Webhook subscriptions (HMAC-signed ItemAvailability events)
+sub = client.webhooks.create(
+  url: 'https://example.com/v1/tango/webhooks',
+  eventTypes: ['ItemAvailability'],
+  headers: [{ name: 'X-Subscription-Generation', value: '1' }],
+  payloadVerificationMethod: 'HMAC',
+  hmacSharedSecretKey: Base64.strict_encode64(SecureRandom.bytes(32))
+)
+client.webhooks.renew(sub['webhookId'])                       # => { 'webhookId', 'expiresAt' }
+client.webhooks.events(sub['webhookId'], fromRevision: 0, maxResults: 100)
+client.webhooks.replay(sub['webhookId'], from_revision: 0)    # redeliver up to 3 months back
+client.webhooks.test(sub['webhookId'], 'ItemAvailability')     # sandbox only
 ```
 
 ### Resources overview
@@ -122,6 +135,7 @@ client.orders.resend('ORDER-123', idempotency_key: idempotency)
 | Resource  | Class                             | Methods (args)                                                                        | HTTP / Path                                        |
 |-----------|-----------------------------------|----------------------------------------------------------------------------------------|----------------------------------------------------|
 | Catalogs  | `Tango::Api::Resources::Catalogs` | `get(params = {})`                                                                     | GET `/catalogs`                                    |
+| Brand Categories | `Tango::Api::Resources::BrandCategories` | `get`                                                                                  | GET `/brandCategories`                            |
 | Orders    | `Tango::Api::Resources::Orders`   | `create(body)`, `get(order_id)`, `list(params = {})`, `resend(order_id)`               | POST `/orders`; GET `/orders/{id}`; GET `/orders`; POST `/orders/{id}/resend` |
 | Accounts  | `Tango::Api::Resources::Accounts` | `get(account_identifier)`, `list_for_customer(customer_identifier, params)`, `create(customer_identifier, body)`, `update_under_customer(customer_identifier, account_identifier, body)`, low balance alerts: `list_low_balance_alerts`, `set_low_balance_alert`, `get_low_balance_alert`, `update_low_balance_alert`, `delete_low_balance_alert` | GET `/accounts/{accountIdentifier}`; GET/POST/PATCH/DELETE under `/customers/{customerIdentifier}/accounts/...` |
 | Customers | `Tango::Api::Resources::Customers`| `list(params = {})`, `get(customer_identifier)`, `create(body)`, `accounts(customer_identifier, params)` | GET `/customers`; GET `/customers/{customerIdentifier}`; POST `/customers`; GET `/customers/{customerIdentifier}/accounts` |
@@ -129,6 +143,7 @@ client.orders.resend('ORDER-123', idempotency_key: idempotency)
 | Status    | `Tango::Api::Resources::Status`   | `get`                                                                                  | GET `/status`                                      |
 | Exchange Rates | `Tango::Api::Resources::ExchangeRates` | `get(params = {})`, `get_for_utid(utid, params = {})`                            | GET `/exchangeRates`; GET `/exchangeRates/{utid}`  |
 | Choice Products | `Tango::Api::Resources::ChoiceProducts` | `get(params = {})`, `get_for_utid(utid)`, `catalog(choice_product_utid, params = {})` | GET `/choiceProducts`; GET `/choiceProducts/{utid}`; GET `/choiceProducts/{utid}/catalog` |
+| Webhooks | `Tango::Api::Resources::Webhooks` | `create(body)`, `list(params = {})`, `get(webhook_id)`, `update(webhook_id, body)`, `delete(webhook_id)`, `renew(webhook_id)`, `events(webhook_id, params = {})`, `replay(webhook_id, from_revision:, to_revision: nil)`, `test(webhook_id, test_name)` | POST/GET `/webhooks`; GET/PATCH/DELETE `/webhooks/{webhookId}`; POST `/webhooks/{webhookId}/renew`; GET `/webhooks/{webhookId}/events`; POST `/webhooks/{webhookId}/replay`; POST `/webhooks/{webhookId}/tests/{testName}` |
 
 ### Smoke test
 

data/lib/tango/api/client/version.rb

@@ -3,7 +3,7 @@
 module Tango
   module Api
     class Client
-      VERSION = "0.1.1"
+      VERSION = "0.2.0"
     end
   end
 end

data/lib/tango/api/client.rb

@@ -19,6 +19,8 @@ require_relative "resources/customers"
 require_relative "resources/status"
 require_relative "resources/exchange_rates"
 require_relative "resources/choice_products"
+require_relative "resources/brand_categories"
+require_relative "resources/webhooks"
 
 module Tango
   module Api
@@ -78,6 +80,14 @@ module Tango
         Resources::ChoiceProducts.new(@conn)
       end
 
+      def brand_categories
+        Resources::BrandCategories.new(@conn)
+      end
+
+      def webhooks
+        Resources::Webhooks.new(@conn)
+      end
+
       private
 
       def build_connection

data/lib/tango/api/resources/base.rb

@@ -53,6 +53,19 @@ module Tango
           raise map_faraday_error(e)
         end
 
+        # POST with no request body, for action endpoints that take only path and query
+        # parameters (e.g. webhook renew, replay, tests). Empty or non-JSON success bodies
+        # such as "OK" are returned as {} or { "raw" => body }.
+        def post_without_body(path, params = nil)
+          response = @conn.post(path) { |req| req.params.update(params) if params }
+          ensure_success_or_raise(response)
+          return {} if response.body.to_s.strip.empty?
+
+          parse_json_response(response)
+        rescue Faraday::Error => e
+          raise map_faraday_error(e)
+        end
+
         def delete_json(path)
           response = @conn.delete(path)
           ensure_success_or_raise(response)

data/lib/tango/api/resources/brand_categories.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Tango
+  module Api
+    module Resources
+      # Resource for Brand Categories endpoints.
+      class BrandCategories < Base
+        # GET /brandCategories
+        def get
+          get_json("brandCategories")
+        end
+      end
+    end
+  end
+end

data/lib/tango/api/resources/webhooks.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Tango
+  module Api
+    module Resources
+      # Webhook subscriptions: create, manage, renew, and read or redeliver past events.
+      class Webhooks < Base
+        # POST /webhooks
+        # Body keys: url (required), eventTypes and/or categories, headers ([{ name:, value: }]),
+        # payloadVerificationMethod ("HMAC", "X509" or "NONE"), hmacSharedSecretKey (base64),
+        # signingCertificate (base64).
+        # Returns { "webhookId" => ..., "expiresAt" => ... }.
+        def create(body)
+          post_json("webhooks", body)
+        end
+
+        # GET /webhooks
+        # Params may include: prevCursor, nextCursor, maxResults (default 10, max 200), url,
+        # headerName, headerValue, categories, eventTypes, expiresAtFrom/To, createdAtFrom/To.
+        def list(params = {})
+          get_json("webhooks", params)
+        end
+
+        # GET /webhooks/{webhookId}
+        def get(webhook_id)
+          get_json("webhooks/#{webhook_id}")
+        end
+
+        # PATCH /webhooks/{webhookId}
+        # Body keys as for #create; all optional.
+        def update(webhook_id, body)
+          patch_json("webhooks/#{webhook_id}", body)
+        end
+
+        # DELETE /webhooks/{webhookId}
+        def delete(webhook_id)
+          delete_json("webhooks/#{webhook_id}")
+        end
+
+        # POST /webhooks/{webhookId}/renew
+        # Returns { "webhookId" => ..., "expiresAt" => ... }.
+        def renew(webhook_id)
+          post_without_body("webhooks/#{webhook_id}/renew")
+        end
+
+        # GET /webhooks/{webhookId}/events
+        # Params may include: fromRevision, toRevision, prevCursor, nextCursor, maxResults.
+        # Returns a page: { "items" => [...], "nextCursor", "nextPageAvailable", ... }.
+        def events(webhook_id, params = {})
+          get_json("webhooks/#{webhook_id}/events", params)
+        end
+
+        # POST /webhooks/{webhookId}/replay?fromRevision=&toRevision=
+        # Redelivers past events (up to three months old). Omitting to_revision replays
+        # through the latest event.
+        def replay(webhook_id, from_revision:, to_revision: nil)
+          params = { fromRevision: from_revision }
+          params[:toRevision] = to_revision unless to_revision.nil?
+          post_without_body("webhooks/#{webhook_id}/replay", params)
+        end
+
+        # POST /webhooks/{webhookId}/tests/{testName}
+        # testName: ConnectivityTest (any environment) or, in the sandbox only, an event type
+        # such as ItemAvailability.
+        def test(webhook_id, test_name)
+          post_without_body("webhooks/#{webhook_id}/tests/#{test_name}")
+        end
+      end
+    end
+  end
+end

data/sig/tango/api/client.rbs

@@ -15,6 +15,7 @@ module Tango
       def status: Resources::Status
       def exchange_rates: Resources::ExchangeRates
       def choice_products: Resources::ChoiceProducts
+      def brand_categories: Resources::BrandCategories
     end
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tango-api-client
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Puneeth Kumar DN
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -88,6 +87,7 @@ files:
 - lib/tango/api/errors.rb
 - lib/tango/api/resources/accounts.rb
 - lib/tango/api/resources/base.rb
+- lib/tango/api/resources/brand_categories.rb
 - lib/tango/api/resources/catalogs.rb
 - lib/tango/api/resources/choice_products.rb
 - lib/tango/api/resources/customers.rb
@@ -95,6 +95,7 @@ files:
 - lib/tango/api/resources/funds.rb
 - lib/tango/api/resources/orders.rb
 - lib/tango/api/resources/status.rb
+- lib/tango/api/resources/webhooks.rb
 - sig/tango/api/client.rbs
 homepage: https://github.com/Engagedly-Inc/tango-api-client
 licenses:
@@ -104,7 +105,6 @@ metadata:
   source_code_uri: https://github.com/Engagedly-Inc/tango-api-client
   changelog_uri: https://github.com/Engagedly-Inc/tango-api-client/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -119,8 +119,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby client for Tango (BHN) API with dual auth and robust errors.
 test_files: []