schematichq 1.4.0

data/lib/schematic/billing/types/list_invoices_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class ListInvoicesResponse < Internal::Types::Model
+        field :data, -> { Internal::Types::Array[Schematic::Types::InvoiceResponseData] }, optional: false, nullable: false
+        field :params, -> { Schematic::Billing::Types::ListInvoicesParams }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/list_meters_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      # Input parameters
+      class ListMetersParams < Internal::Types::Model
+        field :display_name, -> { String }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/list_meters_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class ListMetersRequest < Internal::Types::Model
+        field :display_name, -> { String }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/list_meters_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class ListMetersResponse < Internal::Types::Model
+        field :data, -> { Internal::Types::Array[Schematic::Types::BillingMeterResponseData] }, optional: false, nullable: false
+        field :params, -> { Schematic::Billing::Types::ListMetersParams }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/list_payment_methods_params.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      # Input parameters
+      class ListPaymentMethodsParams < Internal::Types::Model
+        field :company_id, -> { String }, optional: true, nullable: false
+        field :customer_external_id, -> { String }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/list_payment_methods_request.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class ListPaymentMethodsRequest < Internal::Types::Model
+        field :company_id, -> { String }, optional: true, nullable: false
+        field :customer_external_id, -> { String }, optional: false, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/list_payment_methods_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class ListPaymentMethodsResponse < Internal::Types::Model
+        field :data, -> { Internal::Types::Array[Schematic::Types::PaymentMethodResponseData] }, optional: false, nullable: false
+        field :params, -> { Schematic::Billing::Types::ListPaymentMethodsParams }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_billing_coupon_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertBillingCouponResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::BillingCouponResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_billing_customer_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertBillingCustomerResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::BillingCustomerResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_billing_meter_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertBillingMeterResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::BillingMeterResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_billing_price_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertBillingPriceResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::BillingPriceResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_billing_product_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertBillingProductResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::BillingProductResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_billing_subscription_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertBillingSubscriptionResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::BillingSubscriptionResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_invoice_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertInvoiceResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::InvoiceResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/billing/types/upsert_payment_method_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Billing
+    module Types
+      class UpsertPaymentMethodResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::PaymentMethodResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/cache.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module Schematic
+  module CacheProvider
+    def get(key)
+      raise NotImplementedError
+    end
+
+    def set(key, value, ttl: nil)
+      raise NotImplementedError
+    end
+
+    def delete(key)
+      raise NotImplementedError
+    end
+
+    def delete_missing(keys_to_keep)
+      # Optional: remove all keys NOT in keys_to_keep
+    end
+  end
+
+  class LocalCache
+    include CacheProvider
+
+    DEFAULT_MAX_SIZE = 1000
+    DEFAULT_TTL = 5.0 # seconds
+
+    def initialize(max_size: DEFAULT_MAX_SIZE, ttl: DEFAULT_TTL)
+      @max_size = max_size
+      @ttl = ttl
+      # Ruby's Hash maintains insertion order, so we use it as an ordered map.
+      # Re-inserting a key moves it to the end, giving us O(1) LRU touch.
+      @cache = {} # key => CacheEntry (insertion order = LRU order)
+      @mutex = Mutex.new
+      @stopped = false
+
+      start_cleanup if @max_size.positive? && @ttl.positive?
+    end
+
+    def get(key)
+      @mutex.synchronize do
+        entry = @cache[key]
+        return nil unless entry
+
+        if entry.expired?
+          @cache.delete(key)
+          return nil
+        end
+        touch(key)
+        entry.value
+      end
+    end
+
+    def set(key, value, ttl: nil)
+      @mutex.synchronize do
+        effective_ttl = ttl || @ttl
+        return if @max_size <= 0
+
+        if @cache.key?(key)
+          @cache.delete(key)
+          @cache[key] = CacheEntry.new(value, effective_ttl)
+        else
+          evict_lru while @cache.size >= @max_size
+          @cache[key] = CacheEntry.new(value, effective_ttl)
+        end
+      end
+    end
+
+    def delete(key)
+      @mutex.synchronize do
+        @cache.delete(key)
+      end
+    end
+
+    def delete_missing(keys_to_keep)
+      keep_set = keys_to_keep.to_set
+      @mutex.synchronize do
+        @cache.delete_if { |k, _| !keep_set.include?(k) }
+      end
+    end
+
+    def size
+      @mutex.synchronize { @cache.size }
+    end
+
+    def stop
+      @mutex.synchronize { @stopped = true }
+    end
+
+    private
+
+    # O(1) touch: delete + re-insert moves key to end of ordered Hash
+    def touch(key)
+      entry = @cache.delete(key)
+      @cache[key] = entry if entry
+    end
+
+    def evict_lru
+      oldest_key, = @cache.first
+      @cache.delete(oldest_key) if oldest_key
+    end
+
+    def start_cleanup
+      cleanup_interval = (@ttl / 4.0).clamp(1.0, 60.0)
+      @cleanup_thread = Thread.new do
+        loop do
+          sleep(cleanup_interval)
+          break if @stopped
+
+          @mutex.synchronize do
+            @cache.delete_if { |_, entry| entry.expired? }
+          end
+        end
+      end
+      @cleanup_thread.abort_on_exception = false
+    end
+
+    # :nodoc:
+    class CacheEntry
+      attr_reader :value, :ttl, :created_at
+
+      def initialize(value, ttl)
+        @value = value
+        @ttl = ttl
+        @created_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      end
+
+      def expired?
+        Process.clock_gettime(Process::CLOCK_MONOTONIC) - created_at > ttl
+      end
+    end
+  end
+end

data/lib/schematic/checkout/client.rb

@@ -0,0 +1,243 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Checkout
+    class Client
+      # @param client [Schematic::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # @param request_options [Hash]
+      # @param params [Schematic::Types::ChangeSubscriptionInternalRequestBody]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @return [Schematic::Checkout::Types::CheckoutInternalResponse]
+      def internal(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "checkout-internal",
+          body: Schematic::Types::ChangeSubscriptionInternalRequestBody.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Schematic::Checkout::Types::CheckoutInternalResponse.load(response.body)
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Schematic::Checkout::Types::CheckoutDataRequestBody]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @return [Schematic::Checkout::Types::GetCheckoutDataResponse]
+      def get_checkout_data(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "checkout-internal/data",
+          body: Schematic::Checkout::Types::CheckoutDataRequestBody.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Schematic::Checkout::Types::GetCheckoutDataResponse.load(response.body)
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Schematic::Types::ChangeSubscriptionInternalRequestBody]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @return [Schematic::Checkout::Types::PreviewCheckoutInternalResponse]
+      def preview_checkout_internal(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "checkout-internal/preview",
+          body: Schematic::Types::ChangeSubscriptionInternalRequestBody.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Schematic::Checkout::Types::PreviewCheckoutInternalResponse.load(response.body)
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Schematic::Types::ManagePlanRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @return [Schematic::Checkout::Types::ManagePlanResponse]
+      def manage_plan(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "manage-plan",
+          body: Schematic::Types::ManagePlanRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Schematic::Checkout::Types::ManagePlanResponse.load(response.body)
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Schematic::Types::ManagePlanRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @return [Schematic::Checkout::Types::PreviewManagePlanResponse]
+      def preview_manage_plan(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "manage-plan/preview",
+          body: Schematic::Types::ManagePlanRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Schematic::Checkout::Types::PreviewManagePlanResponse.load(response.body)
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Schematic::Checkout::Types::CancelSubscriptionRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @return [Schematic::Checkout::Types::CancelSubscriptionResponse]
+      def cancel_subscription(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "manage-plan/subscription/cancel",
+          body: Schematic::Checkout::Types::CancelSubscriptionRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Schematic::Checkout::Types::CancelSubscriptionResponse.load(response.body)
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Schematic::Checkout::Types::UpdateTrialEndRequestBody]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :subscription_id
+      #
+      # @return [Schematic::Checkout::Types::UpdateCustomerSubscriptionTrialEndResponse]
+      def update_customer_subscription_trial_end(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request_data = Schematic::Checkout::Types::UpdateTrialEndRequestBody.new(params).to_h
+        non_body_param_names = ["subscription_id"]
+        body = request_data.except(*non_body_param_names)
+
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PUT",
+          path: "subscription/#{URI.encode_uri_component(params[:subscription_id].to_s)}/edit-trial-end",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Schematic::Checkout::Types::UpdateCustomerSubscriptionTrialEndResponse.load(response.body)
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/schematic/checkout/types/cancel_subscription_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Checkout
+    module Types
+      class CancelSubscriptionRequest < Internal::Types::Model
+        field :cancel_immediately, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        field :company_id, -> { String }, optional: false, nullable: false
+        field :prorate, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/checkout/types/cancel_subscription_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Checkout
+    module Types
+      class CancelSubscriptionResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::ManagePlanResponseResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/checkout/types/checkout_data_request_body.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Checkout
+    module Types
+      class CheckoutDataRequestBody < Internal::Types::Model
+        field :company_id, -> { String }, optional: false, nullable: false
+        field :selected_plan_id, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/checkout/types/checkout_internal_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Checkout
+    module Types
+      class CheckoutInternalResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::CheckoutSubscription }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/checkout/types/get_checkout_data_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Checkout
+    module Types
+      class GetCheckoutDataResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::CheckoutDataResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/checkout/types/manage_plan_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Checkout
+    module Types
+      class ManagePlanResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::ManagePlanResponseResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end