philiprehberger-webhook_builder 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7754a65fd17d3f711872d837db0a95670d245eab1da96df4d42c723b8d7f9f3d
-  data.tar.gz: 8be04c1b22974980e572ca5073279d995f6e8f67d8853742de62297e5951a532
+  metadata.gz: 5c3d746e099083b6d9da206ce5b4630ca0a4c5ee2c4f1f99373af3c992d89c38
+  data.tar.gz: 23ed5e8d7b8e40f27a71cf7f4cb42c91d501ef8a5028d39d0a77cd1d08a589be
 SHA512:
-  metadata.gz: 5f756201c37028a4f44d5975200d24fb811d87ecbc13467b9a9f3e5c792333c26dc546177871b9bda42d4bef3da1093202aa5f82279622521bf5c443d4fe61f8
-  data.tar.gz: c09e9a31e51d343140eb0beaa1db83560bd7a35dca976f00332534a888ece0eb8263a9701a6b5bf14720388ad381245b44b089689700fa0298ff9a5b16130742
+  metadata.gz: 7e503cd54a9fb91a78879f0ccd541a24b91a447ca30ba89c7d832a4c757d07de2a35e7c0066c8c0e13c01b130f6765afdc96b4b8e234c4ba60d492aba2d3e536
+  data.tar.gz: 6f9942dc1678940173ab109c17b236f83bf14087ed1dae8880f17a2703e8e89a87c2455e752ea7c9b6aff14f6992bd408db65bd46b0499729ec8644d27e7d561

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-22
+
+### Added
+- `Client#signature_for(body:)` — compute the HMAC-SHA256 signature this client would send for a given body without performing a delivery.
+
 ## [0.3.0] - 2026-04-18
 
 ### Added

data/README.md

@@ -134,6 +134,24 @@ receiver.verify_signature(body: body, signature: signature) # => true
 receiver.verify_signature(body: body, signature: "tampered") # => false
 ```
 
+You can also compute the signature the client would send for a body without
+performing a delivery — useful for preparing payloads offline or mirroring
+`verify_signature`:
+
+```ruby
+require "philiprehberger/webhook_builder"
+
+client = Philiprehberger::WebhookBuilder.new(
+  url: "https://example.com/webhooks",
+  secret: "shared-signing-secret"
+)
+
+body = '{"event":"order.created","payload":{"id":1}}'
+signature = client.signature_for(body: body)
+
+client.verify_signature(body: body, signature: signature) # => true
+```
+
 ### Delivery Tracking
 
 ```ruby
@@ -164,6 +182,7 @@ delivery.error          # => nil or error message
 | `#deliver(event:, payload:, headers:)` | Deliver a webhook event and return a Delivery |
 | `#deliver_batch(events)` | Deliver multiple events concurrently and return an array of Delivery results |
 | `#verify_signature(body:, signature:)` | Constant-time HMAC-SHA256 verification of an incoming signature; returns `true`/`false` and never raises |
+| `#signature_for(body:)` | Compute the HMAC-SHA256 signature for a body without sending |
 
 ### `Delivery`
 

data/lib/philiprehberger/webhook_builder/client.rb

@@ -153,6 +153,18 @@ module Philiprehberger
         OpenSSL.fixed_length_secure_compare(expected, signature)
       end
 
+      # Compute the HMAC-SHA256 hex signature this client would send for the given body.
+      #
+      # Mirrors +verify_signature+: the signature returned by +signature_for(body:)+
+      # will verify against the same body. Useful when preparing payloads offline or
+      # re-computing signatures without sending a request.
+      #
+      # @param body [String] the raw request body
+      # @return [String] the hex-encoded HMAC signature
+      def signature_for(body:)
+        sign(body)
+      end
+
       private
 
       # Sign the request body with HMAC-SHA256.

data/lib/philiprehberger/webhook_builder/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module WebhookBuilder
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-webhook_builder
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-19 00:00:00.000000000 Z
+date: 2026-04-22 00:00:00.000000000 Z
 dependencies: []
 description: A webhook delivery client that signs payloads with HMAC-SHA256, retries
   failed deliveries with configurable backoff strategies, supports batch delivery,