skink-sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e365da613e60c986c16faeaca3cad943ff957b8ee29cd7b53f817355ba478974
+  data.tar.gz: bc66b3016edcc0eaffcd5d526d307aa13c7f757ed9466f1514912c265b8af5a3
+SHA512:
+  metadata.gz: 1fd79a34a16e6c274c45079221a1208de3fb2cbd09802db49855fdaadaf02fdfa56312dd428656316a0296a7aff272fa4f3e685967d55657b377329fc4f97663
+  data.tar.gz: 11e697c84e11d2635ec4245419140aa24f8bb7ed3d34df701d2aba0f1e2fe3278ac63dbde5e7436f902b318be4fe5427e65c7ae4b1fc67db882f83575ecce9c7

data/lib/skink.rb

@@ -0,0 +1,93 @@
+require "net/http"
+require "json"
+require "uri"
+
+module Skink
+  class Error < StandardError
+    attr_reader :status, :code
+
+    def initialize(status, code, message)
+      super(message)
+      @status = status
+      @code = code
+    end
+  end
+
+  # Official server-side client for the skink email verification API.
+  #
+  # Never use this in code that ships to a browser or mobile app — the API
+  # key is a secret credential. Load it from a server-side environment
+  # variable (ENV["SKINK_API_KEY"]), never a literal string in source.
+  class Client
+    def initialize(api_key, base_url: "https://api.skink.dev", timeout: 30)
+      raise ArgumentError, "Client requires an api_key (from a server-side env var, not a literal)." if api_key.nil? || api_key.empty?
+
+      @api_key = api_key
+      @base_url = base_url.chomp("/")
+      @timeout = timeout
+    end
+
+    def verify(email, timeout_ms: nil, idempotency_key: nil)
+      body = { email: email }
+      body[:timeout_ms] = timeout_ms if timeout_ms
+      headers = idempotency_key ? { "Idempotency-Key" => idempotency_key } : {}
+      request(:post, "/v1/verify", body: body.to_json, headers: headers)
+    end
+
+    def upload_file(csv_bytes)
+      request(:post, "/v1/files", body: csv_bytes, content_type: "text/csv")
+    end
+
+    def bulk_create(emails: nil, file_id: nil, callback_url: nil)
+      source = {}
+      source[:emails] = emails if emails
+      source[:file_id] = file_id if file_id
+      body = { source: source }
+      body[:callback_url] = callback_url if callback_url
+      request(:post, "/v1/bulk", body: body.to_json)
+    end
+
+    def bulk_list
+      request(:get, "/v1/bulk")
+    end
+
+    def bulk_status(job_id)
+      request(:get, "/v1/bulk/#{URI::DEFAULT_PARSER.escape(job_id)}")
+    end
+
+    def bulk_results(job_id)
+      request(:get, "/v1/bulk/#{URI::DEFAULT_PARSER.escape(job_id)}/results")
+    end
+
+    protected
+
+    def request(method, path, body: nil, content_type: "application/json", headers: {})
+      uri = URI("#{@base_url}#{path}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = @timeout
+      http.read_timeout = @timeout
+
+      req_class = method == :post ? Net::HTTP::Post : Net::HTTP::Get
+      req = req_class.new(uri)
+      req["Authorization"] = "Bearer #{@api_key}"
+      req["Content-Type"] = content_type
+      headers.each { |k, v| req[k] = v }
+      req.body = body if body
+
+      res = http.request(req)
+      begin
+        parsed = res.body && !res.body.empty? ? JSON.parse(res.body) : {}
+      rescue JSON::ParserError
+        raise if res.is_a?(Net::HTTPSuccess)
+        parsed = {}
+      end
+
+      unless res.is_a?(Net::HTTPSuccess)
+        raise Error.new(res.code.to_i, parsed["error"] || "unknown_error", parsed["message"] || res.message)
+      end
+
+      parsed
+    end
+  end
+end

metadata

@@ -0,0 +1,43 @@
+--- !ruby/object:Gem::Specification
+name: skink-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- skink
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-09-09 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/skink.rb
+homepage: https://skink.dev
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Official server-side Ruby client for the skink email verification API
+test_files: []