schematichq 1.4.2 → 1.4.4

data/lib/schematic/event_buffer.rb

@@ -176,13 +176,19 @@ module Schematic
     # Transform to capture service payload format (differs from Fern API):
     # - Field is `type` not `event_type`
     # - Each event includes `api_key`
+    # Optional metadata (idempotency_key, trusted_client_clock, backfill) is
+    # only included when the caller set it, so we never send explicit nulls.
     def event_to_capture_payload(event)
-      {
+      payload = {
         api_key: @api_key,
         type: event[:event_type],
         body: event[:body],
         sent_at: event[:sent_at] || Time.now.utc.iso8601
       }
+      payload[:idempotency_key] = event[:idempotency_key] unless event[:idempotency_key].nil?
+      payload[:trusted_client_clock] = event[:trusted_client_clock] unless event[:trusted_client_clock].nil?
+      payload[:backfill] = event[:backfill] unless event[:backfill].nil?
+      payload
     end
   end
 end

data/lib/schematic/integrationsapi/client.rb

@@ -124,6 +124,38 @@ module Schematic
         end
       end
 
+      # @param request_options [Hash]
+      # @param params [Schematic::Types::InstallIntegrationRequestBody]
+      # @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::Integrationsapi::Types::InstallIntegrationResponse]
+      def install_integration(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: "integrations/install",
+          body: Schematic::Types::InstallIntegrationRequestBody.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::Integrationsapi::Types::InstallIntegrationResponse.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::Integrationsapi::Types::StartDataImportRequestBody]
       # @option request_options [String] :base_url
@@ -164,8 +196,8 @@ module Schematic
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
-      # @return [Schematic::Integrationsapi::Types::LoadSampleDataSetV2Response]
-      def load_sample_data_set_v_2(request_options: {}, **params)
+      # @return [Schematic::Integrationsapi::Types::LoadSampleDataSetResponse]
+      def load_sample_data_set(request_options: {}, **params)
         Schematic::Internal::Types::Utils.normalize_keys(params)
         request = Schematic::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
@@ -180,7 +212,71 @@ module Schematic
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Schematic::Integrationsapi::Types::LoadSampleDataSetV2Response.load(response.body)
+          Schematic::Integrationsapi::Types::LoadSampleDataSetResponse.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::InstallIntegrationRequestBody]
+      # @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::Integrationsapi::Types::AssumeStripeInstalledResponse]
+      def assume_stripe_installed(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: "integrations/stripe/v2/assume-installed",
+          body: Schematic::Types::InstallIntegrationRequestBody.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::Integrationsapi::Types::AssumeStripeInstalledResponse.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::InstallIntegrationRequestBody]
+      # @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::Integrationsapi::Types::InstallStripeResponse]
+      def install_stripe(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: "integrations/stripe/v2/install",
+          body: Schematic::Types::InstallIntegrationRequestBody.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::Integrationsapi::Types::InstallStripeResponse.load(response.body)
         else
           error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/schematic/integrationsapi/types/assume_stripe_installed_response.rb

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

data/lib/schematic/integrationsapi/types/install_integration_response.rb

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

data/lib/schematic/integrationsapi/types/install_stripe_response.rb

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

data/lib/schematic/integrationsapi/types/{load_sample_data_set_v_2_response.rb → load_sample_data_set_response.rb}

@@ -3,7 +3,7 @@
 module Schematic
   module Integrationsapi
     module Types
-      class LoadSampleDataSetV2Response < Internal::Types::Model
+      class LoadSampleDataSetResponse < Internal::Types::Model
         field :data, -> { Schematic::Types::IntegrationsDataSetResponseData }, optional: false, nullable: false
         field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
       end

data/lib/schematic/logger.rb

@@ -26,7 +26,7 @@ module Schematic
 
     attr_accessor :level
 
-    def initialize(level: :info)
+    def initialize(level: :warn)
       @level = level
       @mutex = Mutex.new
       @io = $stderr

data/lib/schematic/plangroups/types/create_plan_group_request_body.rb

@@ -9,6 +9,7 @@ module Schematic
         field :checkout_collect_address, -> { Internal::Types::Boolean }, optional: false, nullable: false
         field :checkout_collect_email, -> { Internal::Types::Boolean }, optional: false, nullable: false
         field :checkout_collect_phone, -> { Internal::Types::Boolean }, optional: false, nullable: false
+        field :custom_checkout_fields, -> { Internal::Types::Array[Schematic::Types::CheckoutFieldInput] }, optional: true, nullable: false
         field :custom_plan_config, -> { Schematic::Types::CustomPlanConfig }, optional: true, nullable: false
         field :custom_plan_id, -> { String }, optional: true, nullable: false
         field :enable_tax_collection, -> { Internal::Types::Boolean }, optional: false, nullable: false

data/lib/schematic/plangroups/types/update_plan_group_request_body.rb

@@ -10,6 +10,7 @@ module Schematic
         field :checkout_collect_address, -> { Internal::Types::Boolean }, optional: false, nullable: false
         field :checkout_collect_email, -> { Internal::Types::Boolean }, optional: false, nullable: false
         field :checkout_collect_phone, -> { Internal::Types::Boolean }, optional: false, nullable: false
+        field :custom_checkout_fields, -> { Internal::Types::Array[Schematic::Types::CheckoutFieldInput] }, optional: true, nullable: false
         field :custom_plan_config, -> { Schematic::Types::CustomPlanConfig }, optional: true, nullable: false
         field :custom_plan_id, -> { String }, optional: true, nullable: false
         field :enable_tax_collection, -> { Internal::Types::Boolean }, optional: false, nullable: false

data/lib/schematic/planmigrations/client.rb

@@ -56,6 +56,38 @@ module Schematic
         end
       end
 
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @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] :plan_version_company_migration_id
+      #
+      # @return [Schematic::Planmigrations::Types::RetryCompanyMigrationResponse]
+      def retry_company_migration(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: "plan-version-company-migrations/#{URI.encode_uri_component(params[:plan_version_company_migration_id].to_s)}/retry",
+          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::Planmigrations::Types::RetryCompanyMigrationResponse.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 [Hash]
       # @option request_options [String] :base_url
@@ -146,6 +178,38 @@ module Schematic
         end
       end
 
+      # @param request_options [Hash]
+      # @param params [Schematic::Planmigrations::Types::CreateMigrationInput]
+      # @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::Planmigrations::Types::CreateMigrationResponse]
+      def create_migration(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: "plan-version-migrations",
+          body: Schematic::Planmigrations::Types::CreateMigrationInput.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::Planmigrations::Types::CreateMigrationResponse.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 [Hash]
       # @option request_options [String] :base_url
@@ -178,6 +242,43 @@ module Schematic
         end
       end
 
+      # @param request_options [Hash]
+      # @param params [Schematic::Planmigrations::Types::RetryMigrationRequestBody]
+      # @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] :plan_version_migration_id
+      #
+      # @return [Schematic::Planmigrations::Types::RetryMigrationResponse]
+      def retry_migration(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request_data = Schematic::Planmigrations::Types::RetryMigrationRequestBody.new(params).to_h
+        non_body_param_names = ["plan_version_migration_id"]
+        body = request_data.except(*non_body_param_names)
+
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "plan-version-migrations/#{URI.encode_uri_component(params[:plan_version_migration_id].to_s)}/retry",
+          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::Planmigrations::Types::RetryMigrationResponse.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 [Hash]
       # @option request_options [String] :base_url

data/lib/schematic/planmigrations/types/create_migration_input.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Planmigrations
+    module Types
+      class CreateMigrationInput < Internal::Types::Model
+        field :company_ids, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        field :excluded_company_ids, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        field :plan_id, -> { String }, optional: false, nullable: false
+        field :plan_version_id_to, -> { String }, optional: false, nullable: false
+        field :plan_version_ids_from, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+        field :strategy, -> { Schematic::Types::PlanVersionMigrationStrategy }, optional: false, nullable: false
+        field :target_plan_type, -> { Schematic::Types::PlanType }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/planmigrations/types/create_migration_response.rb

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

data/lib/schematic/planmigrations/types/retry_company_migration_response.rb

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

data/lib/schematic/planmigrations/types/retry_migration_request_body.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Planmigrations
+    module Types
+      class RetryMigrationRequestBody < Internal::Types::Model
+        field :plan_version_migration_id, -> { String }, optional: false, nullable: false
+        field :error_codes, -> { Internal::Types::Array[Schematic::Types::MigrationErrorCode] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/planmigrations/types/retry_migration_response.rb

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

data/lib/schematic/plans/client.rb

@@ -95,6 +95,39 @@ module Schematic
         end
       end
 
+      # @param request_options [Hash]
+      # @param params [Schematic::Types::MarkCustomPlanBillingPaidRequestBody]
+      # @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] :custom_plan_billing_id
+      #
+      # @return [Schematic::Plans::Types::MarkCustomPlanBillingPaidResponse]
+      def mark_custom_plan_billing_paid(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PUT",
+          path: "custom-plan-billings/#{URI.encode_uri_component(params[:custom_plan_billing_id].to_s)}/mark-paid",
+          body: params,
+          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::Plans::Types::MarkCustomPlanBillingPaidResponse.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::Plans::Types::RetryCustomPlanBillingRequestBody]
       # @option request_options [String] :base_url
@@ -183,6 +216,7 @@ module Schematic
       # @option params [Schematic::Types::PlanType, nil] :plan_type
       # @option params [String, nil] :q
       # @option params [String, nil] :scoped_to_company_id
+      # @option params [Boolean, nil] :with_entitlements
       # @option params [String, nil] :without_entitlement_for
       # @option params [Boolean, nil] :without_paid_product_id
       # @option params [Integer, nil] :limit
@@ -191,7 +225,7 @@ module Schematic
       # @return [Schematic::Plans::Types::ListPlansResponse]
       def list_plans(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
-        query_param_names = %i[company_id company_scoped_only exclude_company_scoped for_fallback_plan for_initial_plan for_trial_expiry_plan has_product_id ids include_draft_versions plan_type q scoped_to_company_id without_entitlement_for without_paid_product_id limit offset]
+        query_param_names = %i[company_id company_scoped_only exclude_company_scoped for_fallback_plan for_initial_plan for_trial_expiry_plan has_product_id ids include_draft_versions plan_type q scoped_to_company_id with_entitlements without_entitlement_for without_paid_product_id limit offset]
         query_params = {}
         query_params["company_id"] = params[:company_id] if params.key?(:company_id)
         query_params["company_scoped_only"] = params[:company_scoped_only] if params.key?(:company_scoped_only)
@@ -205,6 +239,7 @@ module Schematic
         query_params["plan_type"] = params[:plan_type] if params.key?(:plan_type)
         query_params["q"] = params[:q] if params.key?(:q)
         query_params["scoped_to_company_id"] = params[:scoped_to_company_id] if params.key?(:scoped_to_company_id)
+        query_params["with_entitlements"] = params[:with_entitlements] if params.key?(:with_entitlements)
         query_params["without_entitlement_for"] = params[:without_entitlement_for] if params.key?(:without_entitlement_for)
         query_params["without_paid_product_id"] = params[:without_paid_product_id] if params.key?(:without_paid_product_id)
         query_params["limit"] = params[:limit] if params.key?(:limit)
@@ -540,6 +575,7 @@ module Schematic
       # @option params [Schematic::Types::PlanType, nil] :plan_type
       # @option params [String, nil] :q
       # @option params [String, nil] :scoped_to_company_id
+      # @option params [Boolean, nil] :with_entitlements
       # @option params [String, nil] :without_entitlement_for
       # @option params [Boolean, nil] :without_paid_product_id
       # @option params [Integer, nil] :limit
@@ -548,7 +584,7 @@ module Schematic
       # @return [Schematic::Plans::Types::CountPlansResponse]
       def count_plans(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
-        query_param_names = %i[company_id company_scoped_only exclude_company_scoped for_fallback_plan for_initial_plan for_trial_expiry_plan has_product_id ids include_draft_versions plan_type q scoped_to_company_id without_entitlement_for without_paid_product_id limit offset]
+        query_param_names = %i[company_id company_scoped_only exclude_company_scoped for_fallback_plan for_initial_plan for_trial_expiry_plan has_product_id ids include_draft_versions plan_type q scoped_to_company_id with_entitlements without_entitlement_for without_paid_product_id limit offset]
         query_params = {}
         query_params["company_id"] = params[:company_id] if params.key?(:company_id)
         query_params["company_scoped_only"] = params[:company_scoped_only] if params.key?(:company_scoped_only)
@@ -562,6 +598,7 @@ module Schematic
         query_params["plan_type"] = params[:plan_type] if params.key?(:plan_type)
         query_params["q"] = params[:q] if params.key?(:q)
         query_params["scoped_to_company_id"] = params[:scoped_to_company_id] if params.key?(:scoped_to_company_id)
+        query_params["with_entitlements"] = params[:with_entitlements] if params.key?(:with_entitlements)
         query_params["without_entitlement_for"] = params[:without_entitlement_for] if params.key?(:without_entitlement_for)
         query_params["without_paid_product_id"] = params[:without_paid_product_id] if params.key?(:without_paid_product_id)
         query_params["limit"] = params[:limit] if params.key?(:limit)

data/lib/schematic/plans/types/count_plans_params.rb

@@ -19,6 +19,7 @@ module Schematic
         field :plan_type, -> { Schematic::Types::PlanType }, optional: true, nullable: false
         field :q, -> { String }, optional: true, nullable: false
         field :scoped_to_company_id, -> { String }, optional: true, nullable: false
+        field :with_entitlements, -> { Internal::Types::Boolean }, optional: true, nullable: false
         field :without_entitlement_for, -> { String }, optional: true, nullable: false
         field :without_paid_product_id, -> { Internal::Types::Boolean }, optional: true, nullable: false
       end

data/lib/schematic/plans/types/count_plans_request.rb

@@ -16,6 +16,7 @@ module Schematic
         field :plan_type, -> { Schematic::Types::PlanType }, optional: true, nullable: false
         field :q, -> { String }, optional: true, nullable: false
         field :scoped_to_company_id, -> { String }, optional: true, nullable: false
+        field :with_entitlements, -> { Internal::Types::Boolean }, optional: true, nullable: false
         field :without_entitlement_for, -> { String }, optional: true, nullable: false
         field :without_paid_product_id, -> { Internal::Types::Boolean }, optional: true, nullable: false
         field :limit, -> { Integer }, optional: true, nullable: false

data/lib/schematic/plans/types/list_plans_params.rb

@@ -19,6 +19,7 @@ module Schematic
         field :plan_type, -> { Schematic::Types::PlanType }, optional: true, nullable: false
         field :q, -> { String }, optional: true, nullable: false
         field :scoped_to_company_id, -> { String }, optional: true, nullable: false
+        field :with_entitlements, -> { Internal::Types::Boolean }, optional: true, nullable: false
         field :without_entitlement_for, -> { String }, optional: true, nullable: false
         field :without_paid_product_id, -> { Internal::Types::Boolean }, optional: true, nullable: false
       end

data/lib/schematic/plans/types/list_plans_request.rb

@@ -16,6 +16,7 @@ module Schematic
         field :plan_type, -> { Schematic::Types::PlanType }, optional: true, nullable: false
         field :q, -> { String }, optional: true, nullable: false
         field :scoped_to_company_id, -> { String }, optional: true, nullable: false
+        field :with_entitlements, -> { Internal::Types::Boolean }, optional: true, nullable: false
         field :without_entitlement_for, -> { String }, optional: true, nullable: false
         field :without_paid_product_id, -> { Internal::Types::Boolean }, optional: true, nullable: false
         field :limit, -> { Integer }, optional: true, nullable: false

data/lib/schematic/plans/types/mark_custom_plan_billing_paid_response.rb

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

data/lib/schematic/schematic_client.rb

@@ -56,6 +56,12 @@ module Schematic
     DEFAULT_CACHE_MAX_SIZE = 1000
     DEFAULT_EVENT_BUFFER_PERIOD = 5.0 # seconds (canonical Go value)
 
+    # Optional event metadata accepted via the `options:` keyword on track/identify.
+    # identify only honors :idempotency_key; track also honors :sent_at,
+    # :trusted_client_clock, and :backfill. Fields are only sent when set.
+    TRACK_OPTION_KEYS = %i[idempotency_key sent_at trusted_client_clock backfill].freeze
+    IDENTIFY_OPTION_KEYS = %i[idempotency_key].freeze
+
     def initialize(
       api_key: nil,
       base_url: nil,
@@ -67,7 +73,7 @@ module Schematic
       use_data_stream: false,
       datastream_options: {},
       logger: nil,
-      log_level: :info
+      log_level: :warn
     )
       @api_key = api_key
       @base_url = base_url || DEFAULT_BASE_URL
@@ -251,26 +257,18 @@ module Schematic
 
     # --- Event Submission ---
 
-    def identify(body)
+    def identify(body, options: nil)
       return if @offline
 
-      @event_buffer.push({
-                           event_type: "identify",
-                           body: body,
-                           sent_at: Time.now.utc.iso8601
-                         })
+      @event_buffer.push(build_event("identify", body, options, IDENTIFY_OPTION_KEYS))
     rescue StandardError => e
       @logger.error("Error sending identify event: #{e.message}")
     end
 
-    def track(body)
+    def track(body, options: nil)
       return if @offline
 
-      @event_buffer.push({
-                           event_type: "track",
-                           body: body,
-                           sent_at: Time.now.utc.iso8601
-                         })
+      @event_buffer.push(build_event("track", body, options, TRACK_OPTION_KEYS))
 
       # Update company metrics locally if DataStream is active and connected
       if @datastream_client&.connected? && body[:company]
@@ -495,6 +493,41 @@ module Schematic
       results
     end
 
+    # Build the buffered event hash, applying any caller-supplied options.
+    # Only keys in allowed_keys are honored, and only when explicitly set, so
+    # unset fields never appear on the wire.
+    def build_event(event_type, body, options, allowed_keys)
+      event = {
+        event_type: event_type,
+        body: body,
+        sent_at: Time.now.utc.iso8601
+      }
+      return event unless options.is_a?(Hash)
+
+      allowed_keys.each do |key|
+        value = option_value(options, key)
+        next if value.nil?
+
+        event[key] = key == :sent_at ? normalize_sent_at(value) : value
+      end
+
+      event
+    end
+
+    def option_value(options, key)
+      return options[key] if options.key?(key)
+
+      options[key.to_s]
+    end
+
+    def normalize_sent_at(value)
+      return value if value.is_a?(String)
+      return value.utc.iso8601 if value.respond_to?(:utc)
+      return value.iso8601 if value.respond_to?(:iso8601)
+
+      value
+    end
+
     def enqueue_flag_check_event(flag_key, response, company, user)
       body = {
         flag_key: flag_key,