creem 0.0.1

data/lib/creem/client.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+
+module Creem
+  class Client
+    attr_reader :config
+
+    def initialize(api_key: nil, test_mode: nil, timeout: nil, open_timeout: nil)
+      @config = Configuration.new
+      @config.api_key = api_key || Creem.configuration.api_key
+      @config.test_mode = test_mode.nil? ? Creem.configuration.test_mode : test_mode
+      @config.timeout = timeout || Creem.configuration.timeout
+      @config.open_timeout = open_timeout || Creem.configuration.open_timeout
+
+      raise ConfigurationError, "API key is required" if @config.api_key.nil? || @config.api_key.empty?
+    end
+
+    def products
+      @products ||= Resources::Products.new(self)
+    end
+
+    def checkouts
+      @checkouts ||= Resources::Checkouts.new(self)
+    end
+
+    def subscriptions
+      @subscriptions ||= Resources::Subscriptions.new(self)
+    end
+
+    def customers
+      @customers ||= Resources::Customers.new(self)
+    end
+
+    def transactions
+      @transactions ||= Resources::Transactions.new(self)
+    end
+
+    def licenses
+      @licenses ||= Resources::Licenses.new(self)
+    end
+
+    def discounts
+      @discounts ||= Resources::Discounts.new(self)
+    end
+
+    def get(path, params = {})
+      request(:get, path, params: params)
+    end
+
+    def post(path, body = {})
+      request(:post, path, body: body)
+    end
+
+    private
+
+    def request(method, path, params: {}, body: nil)
+      uri = build_uri(path, params)
+      http = build_http(uri)
+      req = build_request(method, uri, body)
+      response = http.request(req)
+      handle_response(response)
+    end
+
+    def build_uri(path, params)
+      uri = URI.parse("#{@config.base_url}#{path}")
+      if params && !params.empty?
+        query = params.reject { |_k, v| v.nil? }.map { |k, v| "#{k}=#{URI.encode_www_form_component(v)}" }.join("&")
+        uri.query = query unless query.empty?
+      end
+      uri
+    end
+
+    def build_http(uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.read_timeout = @config.timeout
+      http.open_timeout = @config.open_timeout
+      http
+    end
+
+    def build_request(method, uri, body)
+      req = case method
+            when :get then Net::HTTP::Get.new(uri)
+            when :post then Net::HTTP::Post.new(uri)
+            else raise ArgumentError, "Unsupported HTTP method: #{method}"
+            end
+      req["x-api-key"] = @config.api_key
+      req["Content-Type"] = "application/json"
+      req["Accept"] = "application/json"
+      req.body = JSON.generate(body) if body && !body.empty?
+      req
+    end
+
+    def handle_response(response)
+      body = response.body && !response.body.empty? ? JSON.parse(response.body) : nil
+      status = response.code.to_i
+
+      case status
+      when 200..299
+        body
+      when 400
+        raise BadRequestError.new("Bad Request", status: status, body: body)
+      when 401
+        raise AuthenticationError.new("Unauthorized - Invalid or missing API key", status: status, body: body)
+      when 404
+        raise NotFoundError.new("Not Found", status: status, body: body)
+      when 429
+        raise RateLimitError.new("Rate limit exceeded", status: status, body: body)
+      when 500..599
+        raise ServerError.new("Server error", status: status, body: body)
+      else
+        raise ApiError.new("Unexpected response", status: status, body: body)
+      end
+    end
+  end
+end

data/lib/creem/configuration.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Creem
+  class Configuration
+    attr_accessor :api_key, :test_mode, :timeout, :open_timeout
+
+    def initialize
+      @api_key = nil
+      @test_mode = false
+      @timeout = 30
+      @open_timeout = 10
+    end
+
+    def base_url
+      test_mode ? TEST_BASE_URL : PRODUCTION_BASE_URL
+    end
+  end
+end

data/lib/creem/errors.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Creem
+  class Error < StandardError; end
+
+  class ConfigurationError < Error; end
+
+  class ApiError < Error
+    attr_reader :status, :body
+
+    def initialize(message = nil, status: nil, body: nil)
+      @status = status
+      @body = body
+      super(message || "API request failed with status #{status}")
+    end
+  end
+
+  class AuthenticationError < ApiError; end
+  class BadRequestError < ApiError; end
+  class NotFoundError < ApiError; end
+  class RateLimitError < ApiError; end
+  class ServerError < ApiError; end
+  class WebhookSignatureError < Error; end
+end

data/lib/creem/resources/base.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Creem
+  module Resources
+    class Base
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+
+      private
+
+      def get(path, params = {})
+        client.get(path, params)
+      end
+
+      def post(path, body = {})
+        client.post(path, body)
+      end
+    end
+  end
+end

data/lib/creem/resources/checkouts.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Creem
+  module Resources
+    class Checkouts < Base
+      def create(product_id:, success_url: nil, request_id: nil, units: nil, discount_code: nil,
+                 customer: nil, custom_fields: nil, metadata: nil)
+        body = { product_id: product_id }
+        body[:success_url] = success_url if success_url
+        body[:request_id] = request_id if request_id
+        body[:units] = units if units
+        body[:discount_code] = discount_code if discount_code
+        body[:customer] = customer if customer
+        body[:custom_fields] = custom_fields if custom_fields
+        body[:metadata] = metadata if metadata
+        post("/checkouts", body)
+      end
+    end
+  end
+end

data/lib/creem/resources/customers.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Creem
+  module Resources
+    class Customers < Base
+      def list(page_number: 1, page_size: 50)
+        get("/customers/list", page_number: page_number, page_size: page_size)
+      end
+
+      def retrieve(customer_id: nil, email: nil)
+        params = {}
+        params[:customer_id] = customer_id if customer_id
+        params[:email] = email if email
+        get("/customers", params)
+      end
+
+      def billing_portal(customer_id)
+        post("/customers/billing-portal", { customer_id: customer_id })
+      end
+    end
+  end
+end

data/lib/creem/resources/discounts.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Creem
+  module Resources
+    class Discounts < Base
+      def list(page_number: 1, page_size: 10)
+        get("/discounts/search", page_number: page_number, page_size: page_size)
+      end
+    end
+  end
+end

data/lib/creem/resources/licenses.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Creem
+  module Resources
+    class Licenses < Base
+      def list(page_number: 1, page_size: 10)
+        get("/licenses/search", page_number: page_number, page_size: page_size)
+      end
+
+      def validate(key:, instance_id:)
+        post("/licenses/validate", { key: key, instance_id: instance_id })
+      end
+
+      def activate(key:, instance_name:)
+        post("/licenses/activate", { key: key, instance_name: instance_name })
+      end
+
+      def deactivate(key:, instance_id:)
+        post("/licenses/deactivate", { key: key, instance_id: instance_id })
+      end
+    end
+  end
+end

data/lib/creem/resources/products.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Creem
+  module Resources
+    class Products < Base
+      def list(page_number: 1, page_size: 10)
+        get("/products/search", page_number: page_number, page_size: page_size)
+      end
+
+      def retrieve(product_id)
+        get("/products", product_id: product_id)
+      end
+    end
+  end
+end

data/lib/creem/resources/subscriptions.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Creem
+  module Resources
+    class Subscriptions < Base
+      def list(page_number: 1, page_size: 10)
+        get("/subscriptions/search", page_number: page_number, page_size: page_size)
+      end
+
+      def retrieve(subscription_id)
+        get("/subscriptions", subscription_id: subscription_id)
+      end
+
+      def update(id, items: nil, update_behavior: nil)
+        body = {}
+        body[:items] = items if items
+        body[:update_behavior] = update_behavior if update_behavior
+        post("/subscriptions/#{id}", body)
+      end
+
+      def cancel(id, mode: nil, on_execute: nil)
+        body = {}
+        body[:mode] = mode if mode
+        body[:onExecute] = on_execute if on_execute
+        post("/subscriptions/#{id}/cancel", body)
+      end
+    end
+  end
+end

data/lib/creem/resources/transactions.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Creem
+  module Resources
+    class Transactions < Base
+      def list(page_number: 1, page_size: 10)
+        get("/transactions/search", page_number: page_number, page_size: page_size)
+      end
+    end
+  end
+end

data/lib/creem/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Creem
+  VERSION = '0.0.1'
+end

data/lib/creem/webhook.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "openssl"
+
+module Creem
+  class Webhook
+    def self.verify_signature(payload:, secret:, signature:)
+      computed = OpenSSL::HMAC.hexdigest("SHA256", secret, payload)
+      secure_compare(computed, signature)
+    end
+
+    def self.verify_signature!(payload:, secret:, signature:)
+      unless verify_signature(payload: payload, secret: secret, signature: signature)
+        raise WebhookSignatureError, "Invalid webhook signature"
+      end
+
+      true
+    end
+
+    def self.construct_event(payload:, secret:, signature:)
+      verify_signature!(payload: payload, secret: secret, signature: signature)
+      JSON.parse(payload)
+    end
+
+    def self.secure_compare(a, b)
+      return false unless a.bytesize == b.bytesize
+
+      OpenSSL.fixed_length_secure_compare(a, b)
+    end
+
+    private_class_method :secure_compare
+  end
+end

data/lib/creem.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "creem/version"
+require_relative "creem/configuration"
+require_relative "creem/errors"
+require_relative "creem/client"
+require_relative "creem/webhook"
+require_relative "creem/resources/products"
+require_relative "creem/resources/checkouts"
+require_relative "creem/resources/subscriptions"
+require_relative "creem/resources/customers"
+require_relative "creem/resources/transactions"
+require_relative "creem/resources/licenses"
+require_relative "creem/resources/discounts"
+
+module Creem
+  PRODUCTION_BASE_URL = "https://api.creem.io/v1"
+  TEST_BASE_URL = "https://test-api.creem.io/v1"
+
+  class << self
+    def configure
+      yield(configuration)
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: creem
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Creem Contributors
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+description: Official Ruby SDK for Creem - a Merchant of Record platform for SaaS
+  and digital businesses. Manage products, checkouts, subscriptions, customers, transactions,
+  licenses, and discounts.
+email:
+- richard.sun@ai-firstly.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- CHANGELOG.md
+- CLAUDE.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- Makefile
+- README.md
+- Rakefile
+- creem.gemspec
+- docs/api_reference.md
+- docs/architecture.md
+- docs/development.md
+- docs/error_handling.md
+- docs/getting_started.md
+- docs/webhooks.md
+- lib/creem.rb
+- lib/creem/client.rb
+- lib/creem/configuration.rb
+- lib/creem/errors.rb
+- lib/creem/resources/base.rb
+- lib/creem/resources/checkouts.rb
+- lib/creem/resources/customers.rb
+- lib/creem/resources/discounts.rb
+- lib/creem/resources/licenses.rb
+- lib/creem/resources/products.rb
+- lib/creem/resources/subscriptions.rb
+- lib/creem/resources/transactions.rb
+- lib/creem/version.rb
+- lib/creem/webhook.rb
+homepage: https://github.com/ai-firstly/creem-ruby
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/ai-firstly/creem-ruby
+  source_code_uri: https://github.com/ai-firstly/creem-ruby
+  changelog_uri: https://github.com/ai-firstly/creem-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/creem
+  bug_tracker_uri: https://github.com/ai-firstly/creem-ruby/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '5.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby SDK for the Creem payment platform API
+test_files: []