reacon-sdk 0.1.0.beta.4

data/lib/reacon-sdk/api/names_api.rb

@@ -0,0 +1,176 @@
+=begin
+#Reacon API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'cgi'
+
+module Reacon
+  class NamesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # List supported email name patterns
+    # Returns name patterns ranked by score. domain is required and validated; optional first and last query fields do not alter this static pattern list.
+    # @param domain [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :first 
+    # @option opts [String] :last 
+    # @return [NamePatternsResponse]
+    def list_name_patterns(domain, opts = {})
+      data, _status_code, _headers = list_name_patterns_with_http_info(domain, opts)
+      data
+    end
+
+    # List supported email name patterns
+    # Returns name patterns ranked by score. domain is required and validated; optional first and last query fields do not alter this static pattern list.
+    # @param domain [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :first 
+    # @option opts [String] :last 
+    # @return [Array<(NamePatternsResponse, Integer, Hash)>] NamePatternsResponse data, response status code and response headers
+    def list_name_patterns_with_http_info(domain, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NamesApi.list_name_patterns ...'
+      end
+      # verify the required parameter 'domain' is set
+      if @api_client.config.client_side_validation && domain.nil?
+        fail ArgumentError, "Missing the required parameter 'domain' when calling NamesApi.list_name_patterns"
+      end
+      # resource path
+      local_var_path = '/v1/name/schemas'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'domain'] = domain
+      query_params[:'first'] = opts[:'first'] if !opts[:'first'].nil?
+      query_params[:'last'] = opts[:'last'] if !opts[:'last'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'NamePatternsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKey']
+
+      new_options = opts.merge(
+        :operation => :"NamesApi.list_name_patterns",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NamesApi#list_name_patterns\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Verify name-based email patterns
+    # Verifies candidate addresses built from sanitized first and last names. JSON returns patterns, globalStages and results. With Accept: text/event-stream, events contain stages or individual pattern verdicts; ordinary completion is clean EOF, with no aggregate final marker. When no candidates can be built, the stream instead emits a result envelope and ends. Errors can describe individual candidates; an error event is not universally terminal. The operation may consume credits; never reconnect or replay automatically.
+    # @param domain [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :first 
+    # @option opts [String] :last 
+    # @option opts [String] :cache_max_age 
+    # @option opts [String] :only_if_free 
+    # @return [NameVerificationResponse]
+    def verify_name(domain, opts = {})
+      data, _status_code, _headers = verify_name_with_http_info(domain, opts)
+      data
+    end
+
+    # Verify name-based email patterns
+    # Verifies candidate addresses built from sanitized first and last names. JSON returns patterns, globalStages and results. With Accept: text/event-stream, events contain stages or individual pattern verdicts; ordinary completion is clean EOF, with no aggregate final marker. When no candidates can be built, the stream instead emits a result envelope and ends. Errors can describe individual candidates; an error event is not universally terminal. The operation may consume credits; never reconnect or replay automatically.
+    # @param domain [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :first 
+    # @option opts [String] :last 
+    # @option opts [String] :cache_max_age 
+    # @option opts [String] :only_if_free 
+    # @return [Array<(NameVerificationResponse, Integer, Hash)>] NameVerificationResponse data, response status code and response headers
+    def verify_name_with_http_info(domain, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NamesApi.verify_name ...'
+      end
+      # verify the required parameter 'domain' is set
+      if @api_client.config.client_side_validation && domain.nil?
+        fail ArgumentError, "Missing the required parameter 'domain' when calling NamesApi.verify_name"
+      end
+      allowable_values = ["live", "1d", "1w", "1m"]
+      if @api_client.config.client_side_validation && opts[:'cache_max_age'] && !allowable_values.include?(opts[:'cache_max_age'])
+        fail ArgumentError, "invalid value for \"cache_max_age\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'only_if_free'] && !allowable_values.include?(opts[:'only_if_free'])
+        fail ArgumentError, "invalid value for \"only_if_free\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/v1/name/verify'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'domain'] = domain
+      query_params[:'first'] = opts[:'first'] if !opts[:'first'].nil?
+      query_params[:'last'] = opts[:'last'] if !opts[:'last'].nil?
+      query_params[:'cacheMaxAge'] = opts[:'cache_max_age'] if !opts[:'cache_max_age'].nil?
+      query_params[:'onlyIfFree'] = opts[:'only_if_free'] if !opts[:'only_if_free'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'NameVerificationResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKey']
+
+      new_options = opts.merge(
+        :operation => :"NamesApi.verify_name",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NamesApi#verify_name\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/reacon-sdk/api/product_tools_api.rb

@@ -0,0 +1,101 @@
+=begin
+#Reacon API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'cgi'
+
+module Reacon
+  class ProductToolsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Execute a product tool
+    # Execute one of the listed tools using a team API key. Choose the input schema associated with the tool path parameter; the input union alone cannot express that relationship. Read tools return executionId=null and replay=false. Write tools require input.idempotencyKey (16–200 characters), scoped to the team across tools. Reusing a key with the same tool and validated input returns the committed output with replay=true while retained; different input or an unfinished execution returns HTTP 409. The SDK does not automatically retry this dispatcher. Tool scopes describe the shared integration/MCP catalog; this HTTP endpoint uses team API-key authentication and team-access checks. Missing database resources can currently surface as HTTP 500. See each tool for output and pagination semantics.
+    # @param tool [String] 
+    # @param product_tool_request [ProductToolRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [ProductToolExecution]
+    def execute_product_tool(tool, product_tool_request, opts = {})
+      data, _status_code, _headers = execute_product_tool_with_http_info(tool, product_tool_request, opts)
+      data
+    end
+
+    # Execute a product tool
+    # Execute one of the listed tools using a team API key. Choose the input schema associated with the tool path parameter; the input union alone cannot express that relationship. Read tools return executionId=null and replay=false. Write tools require input.idempotencyKey (16–200 characters), scoped to the team across tools. Reusing a key with the same tool and validated input returns the committed output with replay=true while retained; different input or an unfinished execution returns HTTP 409. The SDK does not automatically retry this dispatcher. Tool scopes describe the shared integration/MCP catalog; this HTTP endpoint uses team API-key authentication and team-access checks. Missing database resources can currently surface as HTTP 500. See each tool for output and pagination semantics.
+    # @param tool [String] 
+    # @param product_tool_request [ProductToolRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ProductToolExecution, Integer, Hash)>] ProductToolExecution data, response status code and response headers
+    def execute_product_tool_with_http_info(tool, product_tool_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ProductToolsApi.execute_product_tool ...'
+      end
+      # verify the required parameter 'tool' is set
+      if @api_client.config.client_side_validation && tool.nil?
+        fail ArgumentError, "Missing the required parameter 'tool' when calling ProductToolsApi.execute_product_tool"
+      end
+      # verify enum value
+      allowable_values = ["discover_companies", "discover_people", "domain_finder", "email_count", "person_enrich", "company_enrich", "combined_enrich", "saved_searches_list", "leads_list", "lead_get", "lead_create", "lead_update", "lead_upsert", "lead_delete", "lead_enrich", "lead_bulk_delete", "lead_tags_list", "lead_tag_create", "lead_tag_assign", "lead_tag_remove", "custom_attributes_list", "custom_attribute_create", "lead_lists_list", "lead_list_create", "lead_list_update", "lead_list_delete", "lead_list_add_lead", "lead_list_remove_lead", "companies_list", "company_track", "company_update", "company_delete", "company_lists_list", "company_list_create", "company_list_add", "company_list_remove", "sequences_list", "sequence_recipients_list", "sequence_recipients_add", "sequence_recipient_add", "sequence_recipient_cancel", "sequence_start", "account_info", "usage", "usage_history", "team_members", "connected_apps", "connected_app_push"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(tool)
+        fail ArgumentError, "invalid value for \"tool\", must be one of #{allowable_values}"
+      end
+      # verify the required parameter 'product_tool_request' is set
+      if @api_client.config.client_side_validation && product_tool_request.nil?
+        fail ArgumentError, "Missing the required parameter 'product_tool_request' when calling ProductToolsApi.execute_product_tool"
+      end
+      # resource path
+      local_var_path = '/v1/product/tools/{tool}'.sub('{tool}', CGI.escape(tool.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(product_tool_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ProductToolExecution'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKey']
+
+      new_options = opts.merge(
+        :operation => :"ProductToolsApi.execute_product_tool",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ProductToolsApi#execute_product_tool\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/reacon-sdk/api/stats_api.rb

@@ -0,0 +1,79 @@
+=begin
+#Reacon API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'cgi'
+
+module Reacon
+  class StatsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get public dataset statistics
+    # Returns email and mention counts plus the actions version. This endpoint does not require authentication.
+    # @param [Hash] opts the optional parameters
+    # @return [PublicStats]
+    def get_stats(opts = {})
+      data, _status_code, _headers = get_stats_with_http_info(opts)
+      data
+    end
+
+    # Get public dataset statistics
+    # Returns email and mention counts plus the actions version. This endpoint does not require authentication.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(PublicStats, Integer, Hash)>] PublicStats data, response status code and response headers
+    def get_stats_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: StatsApi.get_stats ...'
+      end
+      # resource path
+      local_var_path = '/v1/stats'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PublicStats'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"StatsApi.get_stats",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: StatsApi#get_stats\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/reacon-sdk/api/verification_api.rb

@@ -0,0 +1,168 @@
+=begin
+#Reacon API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'cgi'
+
+module Reacon
+  class VerificationApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Verify a batch of email addresses
+    # Processes email addresses sequentially. A successful HTTP 200 response contains per-item results or errors. Do not replay the whole batch when only one item fails. This operation may consume credits.
+    # @param batch_verification_request [BatchVerificationRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [BatchVerificationResponse]
+    def verify_batch(batch_verification_request, opts = {})
+      data, _status_code, _headers = verify_batch_with_http_info(batch_verification_request, opts)
+      data
+    end
+
+    # Verify a batch of email addresses
+    # Processes email addresses sequentially. A successful HTTP 200 response contains per-item results or errors. Do not replay the whole batch when only one item fails. This operation may consume credits.
+    # @param batch_verification_request [BatchVerificationRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BatchVerificationResponse, Integer, Hash)>] BatchVerificationResponse data, response status code and response headers
+    def verify_batch_with_http_info(batch_verification_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: VerificationApi.verify_batch ...'
+      end
+      # verify the required parameter 'batch_verification_request' is set
+      if @api_client.config.client_side_validation && batch_verification_request.nil?
+        fail ArgumentError, "Missing the required parameter 'batch_verification_request' when calling VerificationApi.verify_batch"
+      end
+      # resource path
+      local_var_path = '/v1/verify/batch'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(batch_verification_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BatchVerificationResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKey']
+
+      new_options = opts.merge(
+        :operation => :"VerificationApi.verify_batch",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: VerificationApi#verify_batch\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Verify an email address
+    # Returns a final JSON aggregate by default. Accept: text/event-stream selects a finite stream of unnamed data events. Events carry a stage, state, result or error; there is no kind field or [DONE] marker on this endpoint. A result or error is terminal. Verification may consume credits and must not be automatically retried or reconnected.
+    # @param email [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cache_max_age 
+    # @option opts [String] :only_if_free 
+    # @return [VerificationResponse]
+    def verify_email(email, opts = {})
+      data, _status_code, _headers = verify_email_with_http_info(email, opts)
+      data
+    end
+
+    # Verify an email address
+    # Returns a final JSON aggregate by default. Accept: text/event-stream selects a finite stream of unnamed data events. Events carry a stage, state, result or error; there is no kind field or [DONE] marker on this endpoint. A result or error is terminal. Verification may consume credits and must not be automatically retried or reconnected.
+    # @param email [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cache_max_age 
+    # @option opts [String] :only_if_free 
+    # @return [Array<(VerificationResponse, Integer, Hash)>] VerificationResponse data, response status code and response headers
+    def verify_email_with_http_info(email, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: VerificationApi.verify_email ...'
+      end
+      # verify the required parameter 'email' is set
+      if @api_client.config.client_side_validation && email.nil?
+        fail ArgumentError, "Missing the required parameter 'email' when calling VerificationApi.verify_email"
+      end
+      allowable_values = ["live", "1d", "1w", "1m"]
+      if @api_client.config.client_side_validation && opts[:'cache_max_age'] && !allowable_values.include?(opts[:'cache_max_age'])
+        fail ArgumentError, "invalid value for \"cache_max_age\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'only_if_free'] && !allowable_values.include?(opts[:'only_if_free'])
+        fail ArgumentError, "invalid value for \"only_if_free\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/v1/verify'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'email'] = email
+      query_params[:'cacheMaxAge'] = opts[:'cache_max_age'] if !opts[:'cache_max_age'].nil?
+      query_params[:'onlyIfFree'] = opts[:'only_if_free'] if !opts[:'only_if_free'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'VerificationResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKey']
+
+      new_options = opts.merge(
+        :operation => :"VerificationApi.verify_email",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: VerificationApi#verify_email\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end