lipwa 0.1.2 → 0.1.3

data/lib/lipwa/webhooks/jenga.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "base64"
+require "openssl"
+require_relative "../webhook"
+
+module Lipwa
+  module Webhooks
+    # Parses Jenga HQ receive-payment Instant Payment Notifications (IPNs).
+    module Jenga
+      module_function
+
+      # rubocop:disable Metrics/MethodLength
+      def call(body:, headers: {})
+        payload = parse(body)
+        transaction = payload.fetch("transaction", {})
+        authorization = header(headers, "Authorization")
+
+        Lipwa::WebhookEvent.new(
+          provider: :jenga,
+          event_type: :receive_payment,
+          success: transaction["status"].to_s.casecmp?("SUCCESS"),
+          provider_reference: transaction["reference"],
+          message: transaction["remarks"],
+          raw: payload,
+          verifier: lambda do |raw:, username:, password:, **|
+            verify_signature(raw: raw, authorization: authorization, username: username, password: password)
+          end
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def parse(body)
+        body.is_a?(String) ? JSON.parse(body) : body
+      end
+
+      def verify_signature(raw:, authorization:, username:, password:) # rubocop:disable Lint/UnusedMethodArgument
+        return false unless authorization.is_a?(String) && username.is_a?(String) && password.is_a?(String)
+        return false if username.strip.empty? || password.strip.empty?
+
+        expected = "Basic #{Base64.strict_encode64("#{username}:#{password}")}"
+        return false unless authorization.bytesize == expected.bytesize
+
+        OpenSSL.fixed_length_secure_compare(authorization, expected)
+      end
+
+      def header(headers, name)
+        pair = headers.find { |key, _| key.to_s.casecmp?(name) }
+        pair&.last
+      end
+    end
+  end
+end
+
+Lipwa::Webhook.register(:jenga, Lipwa::Webhooks::Jenga)

data/lib/lipwa/webhooks/lnbits.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "openssl"
+require_relative "../webhook"
+
+module Lipwa
+  module Webhooks
+    # Parses LNbits invoice-payment callbacks. LNbits does not sign webhook
+    # bodies by default; the verifier compares a per-invoice token supplied in
+    # the webhook URL instead. Treat the callback only as a notification and
+    # independently confirm payment with #check_invoice before crediting it.
+    module Lnbits
+      module_function
+
+      def call(body:, headers: {}) # rubocop:disable Lint/UnusedMethodArgument
+        payload = parse(body)
+
+        Lipwa::WebhookEvent.new(
+          provider: :lnbits,
+          event_type: :payment,
+          success: !payload.key?("paid") || payload["paid"] == true,
+          provider_reference: payload.fetch("payment_hash"),
+          message: payload["memo"],
+          raw: payload,
+          verifier: method(:verify_signature)
+        )
+      end
+
+      def parse(body)
+        body.is_a?(String) ? JSON.parse(body) : body
+      end
+
+      # This verifies knowledge of a shared URL token, not authenticity of the
+      # body. The ** passthrough preserves the API for a future HMAC mode.
+      def verify_signature(raw: nil, expected_token: nil, provided_token: nil, **) # rubocop:disable Lint/UnusedMethodArgument
+        return false unless expected_token.is_a?(String) && provided_token.is_a?(String)
+        return false if expected_token.strip.empty?
+        return false unless expected_token.bytesize == provided_token.bytesize
+
+        OpenSSL.fixed_length_secure_compare(expected_token, provided_token)
+      end
+    end
+  end
+end
+
+Lipwa::Webhook.register(:lnbits, Lipwa::Webhooks::Lnbits)

data/lib/lipwa.rb

@@ -2,6 +2,7 @@
 
 require_relative "lipwa/version"
 require_relative "lipwa/errors"
+require_relative "lipwa/logging"
 require_relative "lipwa/types"
 require_relative "lipwa/money"
 require_relative "lipwa/response"
@@ -11,8 +12,12 @@ require_relative "lipwa/configuration"
 require_relative "lipwa/capability"
 require_relative "lipwa/gateway"
 require_relative "lipwa/gateways"
+require_relative "lipwa/context"
 require_relative "lipwa/webhook"
 require_relative "lipwa/webhooks/mpesa"
+require_relative "lipwa/webhooks/jenga"
+require_relative "lipwa/webhooks/coop_bank"
+require_relative "lipwa/webhooks/lnbits"
 require_relative "lipwa/contracts/c2b_register_urls_contract"
 require_relative "lipwa/contracts/c2b_simulate_contract"
 require_relative "lipwa/capabilities/c2b"
@@ -22,10 +27,34 @@ require_relative "lipwa/contracts/disbursement_contract"
 require_relative "lipwa/capabilities/disbursement"
 require_relative "lipwa/contracts/status_query_contract"
 require_relative "lipwa/capabilities/status_query"
+require_relative "lipwa/contracts/lightning_invoice_contract"
+require_relative "lipwa/contracts/lightning_invoice_check_contract"
+require_relative "lipwa/contracts/lightning_payment_contract"
+require_relative "lipwa/contracts/lightning_payment_check_contract"
+require_relative "lipwa/capabilities/lightning_invoice"
+require_relative "lipwa/capabilities/lightning_payment"
+require_relative "lipwa/gateways/lnbits"
+require_relative "lipwa/contracts/bank_transfer_contract"
+require_relative "lipwa/capabilities/bank_transfer"
+require_relative "lipwa/contracts/card_payment_contract"
+require_relative "lipwa/contracts/card_transaction_contract"
+require_relative "lipwa/capabilities/purchase"
+require_relative "lipwa/capabilities/authorize"
+require_relative "lipwa/capabilities/capture"
+require_relative "lipwa/capabilities/void"
 require_relative "lipwa/gateways/mpesa"
+require_relative "lipwa/gateways/coop_bank"
 
+require_relative "lipwa/gateways/jenga"
+require_relative "lipwa/gateways/pesapal"
+require_relative "lipwa/gateways/flutterwave"
+require_relative "lipwa/gateways/paystack"
 # Unified payment gateway abstraction for African payment providers.
 module Lipwa
+  def self.context(&block)
+    Context.new(&block)
+  end
+
   def self.gateway(name)
     Gateways[name]
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lipwa
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Paul Oguda
@@ -151,36 +151,77 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- docs/README.md
+- docs/_config.yml
+- docs/_layouts/default.html
+- docs/assets/css/style.css
+- docs/capabilities.md
+- docs/gateways.md
+- docs/getting-started.md
+- docs/index.md
+- docs/reliability.md
+- docs/webhooks.md
 - lib/lipwa.rb
 - lib/lipwa/auth_strategies.rb
+- lib/lipwa/auth_strategies/api_key.rb
 - lib/lipwa/auth_strategies/base.rb
 - lib/lipwa/auth_strategies/bearer_token.rb
+- lib/lipwa/auth_strategies/jenga.rb
 - lib/lipwa/auth_strategies/none.rb
+- lib/lipwa/capabilities/authorize.rb
+- lib/lipwa/capabilities/bank_transfer.rb
 - lib/lipwa/capabilities/c2b.rb
+- lib/lipwa/capabilities/capture.rb
 - lib/lipwa/capabilities/disbursement.rb
+- lib/lipwa/capabilities/lightning_invoice.rb
+- lib/lipwa/capabilities/lightning_payment.rb
+- lib/lipwa/capabilities/purchase.rb
 - lib/lipwa/capabilities/refund.rb
 - lib/lipwa/capabilities/status_query.rb
 - lib/lipwa/capabilities/stk_push.rb
+- lib/lipwa/capabilities/void.rb
 - lib/lipwa/capability.rb
 - lib/lipwa/configuration.rb
+- lib/lipwa/configuration_snapshot.rb
+- lib/lipwa/context.rb
+- lib/lipwa/contracts/bank_transfer_contract.rb
 - lib/lipwa/contracts/c2b_register_urls_contract.rb
 - lib/lipwa/contracts/c2b_simulate_contract.rb
+- lib/lipwa/contracts/card_payment_contract.rb
+- lib/lipwa/contracts/card_transaction_contract.rb
 - lib/lipwa/contracts/disbursement_contract.rb
+- lib/lipwa/contracts/lightning_invoice_check_contract.rb
+- lib/lipwa/contracts/lightning_invoice_contract.rb
+- lib/lipwa/contracts/lightning_payment_check_contract.rb
+- lib/lipwa/contracts/lightning_payment_contract.rb
 - lib/lipwa/contracts/refund_contract.rb
 - lib/lipwa/contracts/status_query_contract.rb
 - lib/lipwa/contracts/stk_push_contract.rb
 - lib/lipwa/errors.rb
 - lib/lipwa/gateway.rb
 - lib/lipwa/gateways.rb
+- lib/lipwa/gateways/coop_bank.rb
+- lib/lipwa/gateways/coop_bank/auth.rb
+- lib/lipwa/gateways/flutterwave.rb
+- lib/lipwa/gateways/jenga.rb
+- lib/lipwa/gateways/jenga/auth.rb
+- lib/lipwa/gateways/lnbits.rb
 - lib/lipwa/gateways/mpesa.rb
 - lib/lipwa/gateways/mpesa/auth.rb
 - lib/lipwa/gateways/mpesa/security_credential.rb
+- lib/lipwa/gateways/paystack.rb
+- lib/lipwa/gateways/pesapal.rb
+- lib/lipwa/gateways/pesapal/auth.rb
 - lib/lipwa/http_adapter.rb
+- lib/lipwa/logging.rb
 - lib/lipwa/money.rb
 - lib/lipwa/response.rb
 - lib/lipwa/types.rb
 - lib/lipwa/version.rb
 - lib/lipwa/webhook.rb
+- lib/lipwa/webhooks/coop_bank.rb
+- lib/lipwa/webhooks/jenga.rb
+- lib/lipwa/webhooks/lnbits.rb
 - lib/lipwa/webhooks/mpesa.rb
 - sig/lipwa.rbs
 homepage: https://github.com/kamalogudah/lipwa