telesink 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b38d9848f1923c7e6e5097cecb4e74e77a10f4b07b88721a99feab0a4f2331b2
+  data.tar.gz: 4b1aab123dbebc5d02ac8f810553dcc56b641325aa82e294e41bf29fd015dc0a
+SHA512:
+  metadata.gz: a7401b47e134000d2df96b98619bf8607f0d26c2077984f6e3243d97648f642ac360d74953ab3564ed7a4c0dd7ef41f4fdb915415ea8649911ff83b65115fe51
+  data.tar.gz: 3da4064dc588e1b4b930235d085e495d8c5d9c7524a01a0d7ece0d96195cb546ba4d084ce1b7db1e011987df0c951b4641887fa3bf98561ece49708ea4f827a6

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Teleisnk Changelog
+
+## [1.0.0][1.0.0] - March 18, 2026
+
+- Initial release.

data/LICENSE.md

@@ -0,0 +1,20 @@
+# The MIT License
+
+Copyright © 2026 Telesink
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the 'Software'), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,78 @@
+# Telesink SDK for Ruby
+
+Official Ruby client for [telesink.com](https://telesink.com) - real-time event tracking.
+
+## Requirements
+
+- Ruby 3.0+
+
+## Getting started
+
+### Install
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem "telesink"
+```
+
+Then run:
+
+```sh
+bundle install
+```
+
+### Configuration
+
+#### Recommended: Environment Variables (zero-code setup)
+
+```sh
+export TELESINK_TOKEN=your_sink_token_here
+# Optional:
+# export TELESINK_BASE_URL=https://custom.telesink.com
+```
+
+The SDK automatically reads these.
+
+#### 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
+```
+
+### Usage
+
+```rb
+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
+)
+```
+
+#### Returns
+
+- `true` - request was sent
+- `false` - disabled or missing token
+
+Failures are never raised. They are logged via your configured logger and fail silently.
+
+### Testing
+
+```
+bundle exec rake test
+```
+
+### License
+
+MIT (see [LICENSE.md](/LICENSE.md)).

data/Rakefile

@@ -0,0 +1,8 @@
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test

data/lib/telesink/version.rb

@@ -0,0 +1,3 @@
+module Telesink
+  VERSION = "1.0.0"
+end

data/lib/telesink.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "securerandom"
+require "logger"
+
+module Telesink
+  class Config
+    attr_accessor :token, :base_url, :enabled, :logger
+
+    def initialize
+      @base_url = ENV.fetch("TELESINK_BASE_URL", "https://telesink.com")
+      @token = ENV["TELESINK_TOKEN"]
+      @enabled = true
+      @logger = ::Logger.new(STDERR)
+    end
+  end
+
+  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.token.to_s.strip.empty?
+
+      payload = {
+        event: event,
+        text: text,
+        emoji: emoji,
+        properties: properties,
+        occurred_at: occurred_at&.utc&.iso8601,
+        idempotency_key: (idempotency_key.to_s.empty? ? SecureRandom.uuid : idempotency_key),
+        sdk: {
+          name:    "telesink.ruby",
+          version: VERSION
+        }
+      }.compact
+
+      safely_send_event(payload, payload[:idempotency_key])
+      true
+    end
+
+    private
+
+    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}")
+    rescue => e
+      config.logger.error("[Telesink] Unexpected error sending '#{payload[:event]}': #{e.class} - #{e.message}")
+    end
+
+    def send_event(payload, idempotency_key)
+      uri = URI("#{config.base_url}/api/v1/sinks/#{config.token}/events")
+
+      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)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        config.logger.warn("[Telesink] API returned #{response.code} for event '#{payload[:event]}'")
+      end
+
+      response
+    end
+  end
+end

data/telesink.gemspec

@@ -0,0 +1,34 @@
+
+require_relative "lib/telesink/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "telesink"
+  spec.version = Telesink::VERSION
+  spec.authors = ["Kyrylo Silin"]
+  spec.email = ["kyrylo@telesink.com"]
+
+  spec.summary = "Track events with Telesink using the official Ruby SDK."
+
+  spec.homepage = "https://telesink.com"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/telesink/telesink-ruby"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ .git .github Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  spec.add_runtime_dependency "logger", "~> 1.7"
+
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rake",     "~> 13.0"
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: telesink
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Kyrylo Silin
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+email:
+- kyrylo@telesink.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.md
+- README.md
+- Rakefile
+- lib/telesink.rb
+- lib/telesink/version.rb
+- telesink.gemspec
+homepage: https://telesink.com
+licenses: []
+metadata:
+  homepage_uri: https://telesink.com
+  source_code_uri: https://github.com/telesink/telesink-ruby
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Track events with Telesink using the official Ruby SDK.
+test_files: []