metrifox-sdk 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f814153e75795c0d87de3d15f3164f73fc6a561be992a209900880d2b8461406
-  data.tar.gz: 5329b40387f7555df0895e7889f0e5f63b52b854571d34816627d159340bccd5
+  metadata.gz: dd2f3f03c15f2b2706851f83e95ddab68004fb5bf722201eae1301e2e5eb0ce9
+  data.tar.gz: 4cc5c6d239788de18628f4a929a2d6a328816ad74372afdf703e0f5993c87f78
 SHA512:
-  metadata.gz: 0efde0b9967198c7f0631b7bd35343f00fa94c56d8cfde2696eb7b6f4405ca6995adb82776f5ea516a6f5e40d132ff1023690e4c0526560ad429879a1dfc605a
-  data.tar.gz: 7c14771a87ad8032448a53d38b20e3ed94fb423c4b674897c9263408cc4693fcfd7033931c1ac66e53c0c962dda0f92f29841aa8b9a35065a1512fd496aa11b1
+  metadata.gz: d429ea4b6554d8da627f4b98687eadf40a02c6cc6a5b98cf8a528cb0f9eb171c16463a530dac6646d63927591080a77f40632ddf71c532cc664abcf5155694ea
+  data.tar.gz: 78b222b28144cfef43f03f26941764fd914bcbfa6d80f5423b6d107833700ab9d6dd55aecc2075e43d927261a5e470bab43bfb8d3c27a9290b1cc9e00b7aae06

data/README.md

@@ -7,7 +7,7 @@ A Ruby SDK for interacting with the Metrifox platform API.
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'metrifox_sdk'
+gem 'metrifox-sdk'
 ```
 
 And then execute:
@@ -19,7 +19,7 @@ $ bundle install
 Or install it yourself as:
 
 ```bash
-$ gem install metrifox_sdk
+$ gem install metrifox-sdk
 ```
 
 ## Usage
@@ -27,25 +27,21 @@ $ gem install metrifox_sdk
 ### Configuration
 
 ```ruby
-require 'metrifox_sdk'
+require 'metrifox-sdk'
 
 # Initialize with configuration
-MetrifoxSDK.init({
-  api_key: "your-api-key",
-  base_url: "https://metrifox-api.staging.useyala.com/api/v1/",
-  web_app_base_url: "https://frontend-v3.staging.useyala.com"
-})
+METRIFOX_SDK = MetrifoxSDK.init({ api_key: "your-api-key"})
 
 # Or set environment variable
 ENV["METRIFOX_API_KEY"] = "your-api-key"
-MetrifoxSDK.init
+METRIFOX_SDK = MetrifoxSDK.init
 ```
 
 ### Access Control
 
 ```ruby
 # Check feature access
-response = MetrifoxSDK.usages.check_access({
+response = METRIFOX_SDK.usages.check_access({
   feature_key: "premium_feature",
   customer_key: "customer_123"
 })
@@ -56,12 +52,39 @@ puts response["can_access"] # true/false
 ### Usage Tracking
 
 ```ruby
-# Record usage event
-response = MetrifoxSDK.usages.record_usage({
+# Basic usage recording
+response = METRIFOX_SDK.usages.record_usage({
   customer_key: "customer_123",
   event_name: "api_call",
   amount: 1
 })
+
+# Advanced usage recording with additional fields
+response = METRIFOX_SDK.usages.record_usage({
+  customer_key: "customer_123",
+  event_name: "api_call",
+  amount: 1,
+  credit_used: 5,
+  event_id: "event_uuid_123",
+  timestamp: 1640995200,
+  metadata: {
+    source: "web_app",
+    feature: "premium_search"
+  }
+})
+
+# Using structured request object
+usage_request = MetrifoxSDK::Types::UsageEventRequest.new(
+  customer_key: "customer_123",
+  event_name: "api_call",
+  amount: 1,
+  credit_used: 5,
+  event_id: "event_uuid_123",
+  timestamp: Time.now.to_i,
+  metadata: { source: "mobile_app" }
+)
+
+response = METRIFOX_SDK.usages.record_usage(usage_request)
 ```
 
 ### Customer Management
@@ -76,7 +99,7 @@ customer_data = {
   display_name: "ACME"
 }
 
-response = MetrifoxSDK.customers.create(customer_data)
+response = METRIFOX_SDK.customers.create(customer_data)
 
 # Update customer
 update_data = {
@@ -84,36 +107,86 @@ update_data = {
   website_url: "https://acme.com"
 }
 
-response = MetrifoxSDK.customers.update("customer_123", update_data)
+response = METRIFOX_SDK.customers.update("customer_123", update_data)
 
 # Get customer
-response = MetrifoxSDK.customers.get_customer({ customer_key: "customer_123" })
+response = METRIFOX_SDK.customers.get_customer({ customer_key: "customer_123" })
 
 # Get customer details
-response = MetrifoxSDK.customers.get_details({ customer_key: "customer_123" })
+response = METRIFOX_SDK.customers.get_details({ customer_key: "customer_123" })
+
+# List customers
+response = METRIFOX_SDK.customers.list
+
+# List customers with pagination
+response = METRIFOX_SDK.customers.list({ page: 2, per_page: 10 })
+
+# List customers with filters
+response = METRIFOX_SDK.customers.list({ 
+  search_term: "TechStart",
+  customer_type: "BUSINESS",
+  date_created: "2025-09-01"
+})
+
+# List customers with combined pagination and filters
+response = METRIFOX_SDK.customers.list({ 
+  page: 1,
+  per_page: 5,
+  search_term: "John",
+  customer_type: "INDIVIDUAL"
+})
 
 # Delete customer
-response = MetrifoxSDK.delete_customer({ customer_key: "customer_123" })
+response = METRIFOX_SDK.customers.delete_customer({ customer_key: "customer_123" })
+
 ```
 
 ### CSV Upload
 
 ```ruby
 # Upload customers via CSV
-response = MetrifoxSDK.customers.upload_csv("/path/to/customers.csv")
+response = METRIFOX_SDK.customers.upload_csv("/path/to/customers.csv")
 
 puts response["data"]["total_customers"]
 puts response["data"]["successful_upload_count"]
 ```
 
-### Using Client Instance
+### Checkout URL Generation
 
 ```ruby
-client = MetrifoxSDK::Client.new({
-  api_key: "your-api-key"
+# Basic checkout URL generation
+checkout_url = METRIFOX_SDK.checkout.url({
+  offering_key: "your_offering_key"
+})
+
+# With optional billing interval
+checkout_url = METRIFOX_SDK.checkout.url({
+  offering_key: "your_offering_key",
+  billing_interval: "monthly"
 })
 
-response = client.usages.check_access({
+# With customer key for pre-filled checkout
+checkout_url = METRIFOX_SDK.checkout.url({
+  offering_key: "your_offering_key",
+  billing_interval: "monthly",
+  customer_key: "customer_123"
+})
+
+# Using structured config object
+checkout_config = MetrifoxSDK::Types::CheckoutConfig.new(
+  offering_key: "your_offering_key",
+  billing_interval: "monthly",
+  customer_key: "customer_123"
+)
+
+checkout_url = METRIFOX_SDK.checkout.url(checkout_config)
+```
+
+### Using Client Instance
+
+```ruby
+
+response = METRIFOX_SDK.usages.check_access({
   feature_key: "premium_feature",
   customer_key: "customer_123"
 })
@@ -130,7 +203,7 @@ access_request = MetrifoxSDK::Types::AccessCheckRequest.new(
   customer_key: "customer_123"
 )
 
-response = MetrifoxSDK.usages.check_access(access_request)
+response = METRIFOX_SDK.usages.check_access(access_request)
 
 # Customer creation with structured data
 customer_request = MetrifoxSDK::Types::CustomerCreateRequest.new(
@@ -140,14 +213,14 @@ customer_request = MetrifoxSDK::Types::CustomerCreateRequest.new(
   legal_name: "Acme Corp"
 )
 
-response = MetrifoxSDK.customers.create(customer_request)
+response = METRIFOX_SDK.customers.create(customer_request)
 ```
 
 ## Error Handling
 
 ```ruby
 begin
-  response = MetrifoxSDK.usages.check_access({
+  response = METRIFOX_SDK.usages.check_access({
     feature_key: "premium_feature",
     customer_key: "customer_123"
   })
@@ -168,4 +241,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/yourus
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/metrifox-sdk.rb

@@ -4,8 +4,11 @@ require_relative "metrifox_sdk/types"
 require_relative "metrifox_sdk/util_methods"
 require_relative "metrifox_sdk/base_api"
 require_relative "metrifox_sdk/base_module"
+require_relative "metrifox_sdk/customers/api"
 require_relative "metrifox_sdk/customers/module"
 require_relative "metrifox_sdk/usages/module"
+require_relative "metrifox_sdk/checkout/api"
+require_relative "metrifox_sdk/checkout/module"
 
 module MetrifoxSDK
   class << self

data/lib/metrifox_sdk/checkout/api.rb

@@ -0,0 +1,15 @@
+require "net/http"
+require "uri"
+require "json"
+require_relative "../base_api"
+
+module MetrifoxSDK::Checkout
+  class API < MetrifoxSDK::BaseApi
+    def fetch_checkout_key(base_url, api_key)
+      uri = URI.join(base_url, "auth/checkout-username")
+      response = make_request(uri, "GET", api_key)
+      data = parse_response(response, "Failed to get tenant checkout settings")
+      data.dig("data", "checkout_username")
+    end
+  end
+end

data/lib/metrifox_sdk/checkout/module.rb

@@ -0,0 +1,59 @@
+require_relative "api"
+require_relative "../base_module"
+
+module MetrifoxSDK
+  module Checkout
+    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)
+        customer_key = get_value(config, :customer_key)
+
+        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
+      end
+
+      private
+
+      def get_checkout_key
+        api.fetch_checkout_key(base_url, api_key)
+      end
+
+      def web_app_base_url
+        @client.web_app_base_url
+      end
+
+      def api
+        @api ||= API.new
+      end
+
+      # Helper method to get value from either hash or struct
+      def get_value(object, key)
+        if object.respond_to?(key)
+          object.public_send(key)
+        elsif object.respond_to?(:[])
+          object[key] || object[key.to_s]
+        else
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/metrifox_sdk/client.rb

@@ -21,6 +21,10 @@ module MetrifoxSDK
       @usages ||= Usages::Module.new(self)
     end
 
+    def checkout
+      @checkout ||= Checkout::Module.new(self)
+    end
+
     private
 
     def get_api_key_from_environment

data/lib/metrifox_sdk/customers/api.rb

@@ -41,6 +41,19 @@ module MetrifoxSDK::Customers
       parse_response(response, "Failed to Fetch Customer Details")
     end
 
+    def customer_list_request(base_url, api_key, request_payload = {})
+      uri = URI.join(base_url, "customers")
+      
+      # Build query parameters from the request payload
+      query_params = build_query_params(request_payload)
+      if query_params && !query_params.empty?
+        uri.query = URI.encode_www_form(query_params)
+      end
+      
+      response = make_request(uri, "GET", api_key)
+      parse_response(response, "Failed to Fetch Customers")
+    end
+
     def upload_customers_csv(base_url, api_key, file_path)
       uri = URI.join(base_url, "customers/csv-upload")
 
@@ -68,6 +81,24 @@ module MetrifoxSDK::Customers
       end
     end
 
+    # Helper method to build query parameters for list requests
+    def build_query_params(request_payload)
+      return {} unless request_payload
+
+      params = {}
+      
+      # Handle pagination parameters
+      params[:page] = get_value(request_payload, :page) if get_value(request_payload, :page)
+      params[:per_page] = get_value(request_payload, :per_page) if get_value(request_payload, :per_page)
+      
+      # Handle filter parameters
+      params[:search_term] = get_value(request_payload, :search_term) if get_value(request_payload, :search_term)
+      params[:customer_type] = get_value(request_payload, :customer_type) if get_value(request_payload, :customer_type)
+      params[:date_created] = get_value(request_payload, :date_created) if get_value(request_payload, :date_created)
+      
+      params.compact
+    end
+
     # Helper method to get value from either hash or struct
     def get_value(object, key)
       if object.respond_to?(key)

data/lib/metrifox_sdk/customers/module.rb

@@ -29,6 +29,11 @@ module MetrifoxSDK
         api.customer_delete_request(base_url, api_key, request_payload)
       end
 
+      def list(request_payload = {})
+        validate_api_key!
+        api.customer_list_request(base_url, api_key, request_payload)
+      end
+
       def upload_csv(file_path)
         validate_api_key!
         api.upload_customers_csv(base_url, api_key, file_path)

data/lib/metrifox_sdk/types.rb

@@ -44,8 +44,11 @@ module MetrifoxSDK
       :carryover_quantity, :balance, keyword_init: true
     )
 
-    UsageEventRequest = Struct.new(:customer_key, :event_name, :amount, keyword_init: true) do
-      def initialize(customer_key:, event_name:, amount: 1)
+    UsageEventRequest = Struct.new(
+      :customer_key, :event_name, :amount, :credit_used, :event_id, :timestamp, :metadata,
+      keyword_init: true
+    ) do
+      def initialize(customer_key:, event_name:, amount: 1, credit_used: nil, event_id: nil, timestamp: nil, metadata: {})
         super
       end
     end
@@ -107,5 +110,6 @@ module MetrifoxSDK
     APIResponse = Struct.new(:status_code, :message, :data, :errors, :meta, keyword_init: true)
 
     EmbedConfig = Struct.new(:container, :product_key, keyword_init: true)
+    CheckoutConfig = Struct.new(:offering_key, :billing_interval, :customer_key, keyword_init: true)
   end
 end

data/lib/metrifox_sdk/usages/api.rb

@@ -29,6 +29,10 @@ module MetrifoxSDK::Usages
       customer_key = get_value(request_payload, :customer_key)
       event_name = get_value(request_payload, :event_name)
       amount = get_value(request_payload, :amount) || 1
+      credit_used = get_value(request_payload, :credit_used)
+      event_id = get_value(request_payload, :event_id)
+      timestamp = get_value(request_payload, :timestamp)
+      metadata = get_value(request_payload, :metadata) || {}
 
       body = {
         customer_key: customer_key,
@@ -36,6 +40,12 @@ module MetrifoxSDK::Usages
         amount: amount
       }
 
+      # Add optional fields if present
+      body[:credit_used] = credit_used if credit_used
+      body[:event_id] = event_id if event_id && !event_id.empty?
+      body[:timestamp] = timestamp if timestamp
+      body[:metadata] = metadata if metadata
+
       response = make_request(uri, "POST", api_key, body)
       parse_response(response, "Failed to record usage")
     end

data/lib/metrifox_sdk/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metrifox-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Metrifox
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-01 00:00:00.000000000 Z
+date: 2025-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -121,6 +121,8 @@ files:
 - lib/metrifox-sdk.rb
 - lib/metrifox_sdk/base_api.rb
 - lib/metrifox_sdk/base_module.rb
+- lib/metrifox_sdk/checkout/api.rb
+- lib/metrifox_sdk/checkout/module.rb
 - lib/metrifox_sdk/client.rb
 - lib/metrifox_sdk/customers/api.rb
 - lib/metrifox_sdk/customers/module.rb