metrifox-sdk 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd2f3f03c15f2b2706851f83e95ddab68004fb5bf722201eae1301e2e5eb0ce9
-  data.tar.gz: 4cc5c6d239788de18628f4a929a2d6a328816ad74372afdf703e0f5993c87f78
+  metadata.gz: 61978214945170e21af55446d8aa5606a14710fa5515cdd327d11227b5f95a22
+  data.tar.gz: cc96ae1ea46452d1d1221b936048bb9ad8931bd93317c727352272f08ad796a6
 SHA512:
-  metadata.gz: d429ea4b6554d8da627f4b98687eadf40a02c6cc6a5b98cf8a528cb0f9eb171c16463a530dac6646d63927591080a77f40632ddf71c532cc664abcf5155694ea
-  data.tar.gz: 78b222b28144cfef43f03f26941764fd914bcbfa6d80f5423b6d107833700ab9d6dd55aecc2075e43d927261a5e470bab43bfb8d3c27a9290b1cc9e00b7aae06
+  metadata.gz: b31ffd58d394c50d65fd22b339f939dcbfa8ae31bb716cce31c759cd1ad9ab584746f1476e1e376541e6ac27539e4abed0b3aca665f6607136a594226881f2bf
+  data.tar.gz: b7e0c2167befb2befc63e50b4cef0b940c0a4f81890933f2100937fe458a3c3a626451d7b4fc103f1f649cc7b6cac83ff79ed74c5fee21b023a5692479256d59

data/README.md

@@ -90,9 +90,9 @@ response = METRIFOX_SDK.usages.record_usage(usage_request)
 ### Customer Management
 
 ```ruby
-# Create customer
+# Create customer (customer_key is REQUIRED)
 customer_data = {
-  customer_key: "customer_123",
+  customer_key: "customer_123",  # Required - unique identifier for the customer
   customer_type: "BUSINESS",
   primary_email: "customer@example.com",
   legal_name: "Acme Corp",
@@ -101,10 +101,11 @@ customer_data = {
 
 response = METRIFOX_SDK.customers.create(customer_data)
 
-# Update customer
+# Update customer (customer_key cannot be changed and is passed as a parameter)
 update_data = {
   display_name: "ACME Corporation",
   website_url: "https://acme.com"
+  # Note: customer_key is NOT included here - it's immutable
 }
 
 response = METRIFOX_SDK.customers.update("customer_123", update_data)
@@ -115,6 +116,10 @@ response = METRIFOX_SDK.customers.get_customer({ customer_key: "customer_123" })
 # Get customer details
 response = METRIFOX_SDK.customers.get_details({ customer_key: "customer_123" })
 
+# Check for an active subscription
+has_active_subscription = MetrifoxSDK.customers.has_active_subscription?(customer_key: "customer_123")
+puts has_active_subscription # true or false
+
 # List customers
 response = METRIFOX_SDK.customers.list
 
@@ -205,15 +210,24 @@ access_request = MetrifoxSDK::Types::AccessCheckRequest.new(
 
 response = METRIFOX_SDK.usages.check_access(access_request)
 
-# Customer creation with structured data
+# Customer creation with structured data (customer_key is REQUIRED)
 customer_request = MetrifoxSDK::Types::CustomerCreateRequest.new(
-  customer_key: "customer_123",
+  customer_key: "customer_123",  # Required
   customer_type: MetrifoxSDK::Types::CustomerType::BUSINESS,
   primary_email: "customer@example.com",
   legal_name: "Acme Corp"
 )
 
 response = METRIFOX_SDK.customers.create(customer_request)
+
+# Customer update with structured data (customer_key is immutable)
+customer_update = MetrifoxSDK::Types::CustomerUpdateRequest.new(
+  display_name: "Acme Corporation",
+  website_url: "https://acme.com"
+  # Note: customer_key is NOT a field in CustomerUpdateRequest
+)
+
+response = METRIFOX_SDK.customers.update("customer_123", customer_update)
 ```
 
 ## Error Handling

data/lib/metrifox_sdk/checkout/api.rb

@@ -11,5 +11,13 @@ module MetrifoxSDK::Checkout
       data = parse_response(response, "Failed to get tenant checkout settings")
       data.dig("data", "checkout_username")
     end
+
+    def generate_checkout_url(base_url, api_key, query_params)
+      uri = URI.join(base_url, "products/offerings/generate-checkout-url")
+      uri.query = URI.encode_www_form(query_params)
+      response = make_request(uri, "GET", api_key)
+      data = parse_response(response, "Failed to generate checkout URL")
+      data.dig("data", "checkout_url")
+    end
   end
 end

data/lib/metrifox_sdk/checkout/module.rb

@@ -6,7 +6,7 @@ module MetrifoxSDK
     class Module < BaseModule
       def url(config)
         validate_api_key!
-        
+
         # Handle both hash and struct access patterns
         offering_key = get_value(config, :offering_key)
         billing_interval = get_value(config, :billing_interval)
@@ -14,20 +14,16 @@ module MetrifoxSDK
 
         raise ArgumentError, "offering_key is required" if offering_key.nil? || offering_key.empty?
 
-        checkout_key = get_checkout_key
-        raise StandardError, "Checkout Key could not be retrieved. Ensure the API key is valid" if checkout_key.nil? || checkout_key.empty?
-
-        url_string = "#{web_app_base_url}/#{checkout_key}/checkout/#{offering_key}"
-        uri = URI(url_string)
-        
-        # Add query parameters if provided
-        query_params = {}
-        query_params["billing_period"] = billing_interval if billing_interval && !billing_interval.empty?
-        query_params["customer"] = customer_key if customer_key && !customer_key.empty?
-        
-        uri.query = URI.encode_www_form(query_params) unless query_params.empty?
-        
-        uri.to_s
+        # Build query parameters
+        query_params = { offering_key: offering_key }
+        query_params[:billing_interval] = billing_interval if billing_interval && !billing_interval.empty?
+        query_params[:customer_key] = customer_key if customer_key && !customer_key.empty?
+
+        # Call API to generate checkout URL
+        checkout_url = api.generate_checkout_url(base_url, api_key, query_params)
+        raise StandardError, "Checkout URL could not be generated" if checkout_url.nil? || checkout_url.empty?
+
+        checkout_url
       end
 
       private

data/lib/metrifox_sdk/customers/api.rb

@@ -41,6 +41,12 @@ module MetrifoxSDK::Customers
       parse_response(response, "Failed to Fetch Customer Details")
     end
 
+    def customer_active_subscription_request(base_url, api_key, customer_key)
+      uri = URI.join(base_url, "customers/#{customer_key}/check-active-subscription")
+      response = make_request(uri, "GET", api_key)
+      parse_response(response, "Failed to Check Active Subscription")
+    end
+
     def customer_list_request(base_url, api_key, request_payload = {})
       uri = URI.join(base_url, "customers")
       
@@ -110,4 +116,4 @@ module MetrifoxSDK::Customers
       end
     end
   end
-end
+end

data/lib/metrifox_sdk/customers/module.rb

@@ -19,16 +19,31 @@ module MetrifoxSDK
         api.customer_get_request(base_url, api_key, request_payload)
       end
 
+      def get(request_payload)
+        get_customer(request_payload)
+      end
+
       def get_details(request_payload)
         validate_api_key!
         api.customer_details_get_request(base_url, api_key, request_payload)
       end
 
+      def has_active_subscription?(customer_key:)
+        validate_api_key!
+        result = api.customer_active_subscription_request(base_url, api_key, customer_key)
+        data = result["data"] || {}
+        data["has_active_subscription"]
+      end
+
       def delete_customer(request_payload)
         validate_api_key!
         api.customer_delete_request(base_url, api_key, request_payload)
       end
 
+      def delete(request_payload)
+        delete_customer(request_payload)
+      end
+
       def list(request_payload = {})
         validate_api_key!
         api.customer_list_request(base_url, api_key, request_payload)
@@ -46,4 +61,4 @@ module MetrifoxSDK
       end
     end
   end
-end
+end

data/lib/metrifox_sdk/types.rb

@@ -56,7 +56,7 @@ module MetrifoxSDK
     UsageEventResponse = Struct.new(:message, :event_name, :customer_key, keyword_init: true)
 
     CustomerCreateRequest = Struct.new(
-      # Core fields
+      # Core fields (customer_key is REQUIRED)
       :customer_key, :customer_type, :primary_email, :primary_phone,
       # Business fields
       :legal_name, :display_name, :legal_number, :tax_identification_number,
@@ -76,8 +76,8 @@ module MetrifoxSDK
     )
 
     CustomerUpdateRequest = Struct.new(
-      # Core fields
-      :customer_key, :customer_type, :primary_email, :primary_phone, :billing_email,
+      # Core fields (customer_key is NOT included - it's immutable and passed as a parameter)
+      :customer_type, :primary_email, :primary_phone, :billing_email,
       # Business fields
       :legal_name, :display_name, :legal_number, :tax_identification_number,
       :logo_url, :website_url, :account_manager,

data/lib/metrifox_sdk/version.rb

@@ -1,3 +1,3 @@
 module MetrifoxSDK
-  VERSION = '1.0.2'
+  VERSION = '1.0.3'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: metrifox-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Metrifox
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-03 00:00:00.000000000 Z
+date: 2025-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -138,7 +137,6 @@ metadata:
   homepage_uri: https://github.com/metrifox/metrifox-ruby
   source_code_uri: https://github.com/metrifox/metrifox-ruby
   changelog_uri: https://github.com/metrifox/metrifox-ruby/tree/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -153,8 +151,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Ruby SDK for Metrifox API
 test_files: []