telesink 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37c631d9215d2254268da1c93897be7abc486dbbc0fdad96e0b8ec3c77654e93
-  data.tar.gz: 8593950cf5dab5bf717554850770cb8440a980227fb5280c31bbe3be822368ec
+  metadata.gz: a79d264813b7ba665cc3deff43aa4fed213cb7b12f213c0646619033d4cd5947
+  data.tar.gz: f78cee29a3575b63b8a2cefcef05c1acf48f65a583827b43fb5c66eed885cbc7
 SHA512:
-  metadata.gz: 3c7eeaa7ec11a3a66c0a709ba9f43c58d1d2187471356c863ce83a3a8704f2c369e878b5aa46b3a04ffd8e5150646b77d2ed4f0015cfe3a31658902ebb0ad1c0
-  data.tar.gz: 8ab94fd8156a62d75fd7b7ceb7f138fc69173654cf29de33dd88ed25ab3fad0a3863d94ed190538b32104d4268965df8d64eb406c3fdd2c5fea9906697013b8c
+  metadata.gz: 8c4ac33341bbb7e543811df49080fc0a09584287d904e4efe7e29775e19e025e6a2e35d1b27058b3e308c406aa1683761c43f2aac311db34f34daf95dd032c42
+  data.tar.gz: 227787e27f4cadf87ddfd8b80799c6f06fc1c3e55f2f00779a334145599abe440e5ffb3777fa84fc4ae0f41d343a4ec6bd38bf2addacc4d54fa77976e17e9ae9

data/CHANGELOG.md

@@ -1,7 +1,13 @@
-# Teleisnk Changelog
+# Telesink Changelog
 
 ## master
 
+## 1.2.0 - 2026-04-19
+
+- Replaced `Telesink.configure` block with `Telesink.init` for simpler setup.
+- Removed `Config` class. Options are now set directly on the module.
+- Added the `TELESINK_DISABLED` environment variable.
+
 ## 1.1.0 - 2026-04-19
 
 - Merged `TELESINK_BASE_URL` and `TELESINK_TOKEN` into `TELESINK_ENDPOINT`.

data/README.md

@@ -1,6 +1,7 @@
 # Telesink SDK for Ruby
 
-Official Ruby client for [telesink.com](https://telesink.com) - real-time event tracking.
+Official Ruby client for [telesink.com](https://telesink.com) - real-time event
+tracking.
 
 ## Requirements
 
@@ -10,7 +11,7 @@ Official Ruby client for [telesink.com](https://telesink.com) - real-time event
 
 ### Install
 
-Add this line to your application's `Gemfile`:
+Add to your `Gemfile`:
 
 ```ruby
 gem "telesink"
@@ -24,27 +25,16 @@ bundle install
 
 ### Configuration
 
-#### Recommended: Environment Variables (zero-code setup)
+Set the environment variable:
 
 ```sh
-export TELESINK_TOKEN=your_sink_token_here
-# Optional:
-# export TELESINK_BASE_URL=https://custom.telesink.com
+export TELESINK_ENDPOINT=https://app.telesink.com/api/v1/sinks/your_sink_token_here/events
 ```
 
-The SDK automatically reads these.
+To disable tracking (e.g. in test/dev):
 
-#### Explicit configuration
-
-```rb
-require "telesink"
-
-Telesink.configure do |config|
-  config.token = <sink-token>              # required
-  config.base_url = "https://telesink.com" # default
-  config.enabled = true                    # default
-  config.logger = Logger.new(STDERR)
-end
+```sh
+export TELESINK_DISABLED=true
 ```
 
 ### Usage
@@ -53,23 +43,26 @@ end
 Telesink.track(
   event: "user.signed.up",
   text: "New user registered",
-  emoji: "🎉",
-  properties: { plan: "pro", source: "landing_page" },
-  occurred_at: Time.now, # optional, auto-converted to UTC ISO8601
-  idempotency_key: "my-custom-key" # optional, auto-generated UUID if omitted
+  emoji: "👤",
+  properties: {
+    plan: "pro",
+    source: "landing_page",
+  },
+  occurred_at: Time.now,     # optional, defaults to now
+  idempotency_key: "my-key", # optional, defaults to random UUID
 )
 ```
 
 #### Returns
 
-- `true` - request was sent
-- `false` - disabled or missing token
+- `true` — event sent successfully
+- `false` — disabled, missing endpoint, or network error
 
-Failures are never raised. They are logged via your configured logger and fail silently.
+Errors are never raised. They are logged to STDERR and fail silently.
 
 ### Testing
 
-```
+```sh
 bundle exec rake test
 ```
 

data/lib/telesink/version.rb

@@ -1,3 +1,3 @@
 module Telesink
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

data/lib/telesink.rb

@@ -9,95 +9,44 @@ require "logger"
 require_relative "telesink/version"
 
 module Telesink
-  class Config
-    attr_accessor :endpoint, :enabled, :logger
-
-    def initialize
-      @endpoint = ENV["TELESINK_ENDPOINT"]
-      @enabled = true
-      @logger = ::Logger.new(STDERR)
-    end
-  end
+  LOG = ::Logger.new(STDERR)
 
   class << self
-    attr_writer :config
-
-    def config
-      @config ||= Config.new
-    end
-
-    def configure
-      yield config
-    end
-
-    def track(
-      event:,
-      text:,
-      emoji: nil,
-      properties: {},
-      occurred_at: nil,
-      idempotency_key: nil
-    )
-      return false unless config.enabled
-      return false if config.endpoint.to_s.empty?
-
-      occurred_at = (occurred_at || Time.now).utc.iso8601
-      idempotency_key = (idempotency_key.to_s.empty? ? SecureRandom.uuid : idempotency_key)
+    def track(event:, text:, emoji: nil, properties: {}, occurred_at: nil, idempotency_key: nil)
+      return false unless enabled? && endpoint
 
       payload = {
         event: event,
         text: text,
         emoji: emoji,
         properties: properties,
-        occurred_at: occurred_at,
-        idempotency_key: idempotency_key,
-        sdk: {
-          name: "telesink.ruby",
-          version: VERSION
-        }
+        occurred_at: (occurred_at || Time.now).utc.iso8601,
+        idempotency_key: idempotency_key || SecureRandom.uuid,
+        sdk: { name: "telesink.ruby", version: VERSION }
       }.compact
 
-      safely_send_event(payload, payload[:idempotency_key])
-      true
-    end
+      uri = URI(endpoint)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = http.read_timeout = 3
+      http.write_timeout = 3 if http.respond_to?(:write_timeout)
 
-    private
+      req = Net::HTTP::Post.new(uri)
+      req["Content-Type"] = "application/json"
+      req["User-Agent"] = "telesink.ruby/#{VERSION}"
+      req["Idempotency-Key"] = payload[:idempotency_key]
+      req.body = payload.to_json
 
-    def safely_send_event(payload, idempotency_key)
-      send_event(payload, idempotency_key)
-    rescue Net::OpenTimeout,
-           Net::ReadTimeout,
-           Net::WriteTimeout,
-           SocketError,
-           SystemCallError,
-           IOError,
-           Errno::ECONNREFUSED,
-           Errno::ECONNRESET => e
-      config.logger.error("[Telesink] Network error sending '#{payload[:event]}': #{e.class} - #{e.message}")
+      http.request(req).is_a?(Net::HTTPSuccess)
     rescue => e
-      config.logger.error("[Telesink] Unexpected error sending '#{payload[:event]}': #{e.class} - #{e.message}")
+      logger.error("[Telesink] #{e.class}: #{e.message}")
+      false
     end
 
-    def send_event(payload, idempotency_key)
-      uri = URI(config.endpoint)
-      http = Net::HTTP.new(uri.host, uri.port)
-      http.use_ssl = true
-      http.open_timeout = 3
-      http.read_timeout = 3
-      http.write_timeout = 3 if http.respond_to?(:write_timeout)
-
-      request = Net::HTTP::Post.new(uri)
-      request["Content-Type"] = "application/json"
-      request["User-Agent"] = "telesink.ruby/#{VERSION}"
-      request["Idempotency-Key"] = idempotency_key
-
-      request.body = payload.to_json
-      response = http.request(request)
+    private
 
-      unless response.is_a?(Net::HTTPSuccess)
-        config.logger.warn("[Telesink] API returned #{response.code} for event '#{payload[:event]}'")
-      end
-      response
-    end
+    def endpoint = ENV["TELESINK_ENDPOINT"]
+    def enabled? = ENV["TELESINK_DISABLED"].to_s.empty?
+    def logger = LOG
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telesink
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Kyrylo Silin