trifle-stats 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '014813aa6a45f6fece54f7fc332272c85023a37236cd3b4eeb270f3f00fed3a0'
-  data.tar.gz: f83d0bfecc64f03cd3160e3762eb09a12d76ea8c9cda78c8108ee063bd8caf50
+  metadata.gz: 053aa86693f158ba5a395ab80396f0b3274bff69481ec80dd4335e782d000bfe
+  data.tar.gz: 86be7c68e870d4fe38eac8dcae73634d8237a5334c8071c610932b22b57c735d
 SHA512:
-  metadata.gz: 71ecb7d927d16ec3f29fec1f57624b8f72bb482841a7a6c0d948ddf8ddc42b0d8b88b858f12436a330189a0731ba41d9514332cfc25e4721c3b7387f11d1c809
-  data.tar.gz: da222c50726b1241f2fbfe86c21553c1fea4393c80e53c065e94ea4895fbf755fb6f1e59d15b61b3d1219d114fb444b1bc4eb935b21e9970a4b704b0348a23fc
+  metadata.gz: cfc8e1a9b317808a37acc6799d87a99d856fe4e4f4b792ac223d96f4ac500b2e6c77e25a5e99e1861047524984cf7ce2bd691a6d930404384b973a173ed49e99
+  data.tar.gz: 383c36c748fa4266b2d741054f1f22a35baff5806ccb5ab169d3a0cf49c9fabad2fae97e64acb86fe2fbd534600acad0fe5ee6edac7a01faea6340c5b1eb1c13

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    trifle-stats (2.5.0)
+    trifle-stats (2.6.0)
       tzinfo (~> 2.0)
 
 GEM
@@ -11,7 +11,7 @@ GEM
     bigdecimal (4.0.1)
     bson (4.12.1)
     byebug (11.1.3)
-    concurrent-ruby (1.3.6)
+    concurrent-ruby (1.3.8)
     diff-lcs (1.4.4)
     dotenv (2.7.6)
     mini_portile2 (2.8.9)

data/README.md

@@ -80,6 +80,7 @@ series.aggregate.sum(path: 'count')
 
 | Driver | Backend | Best for |
 |--------|---------|----------|
+| **API** | Trifle Cloud Projects | Hosted metrics without your own database |
 | **Postgres** | JSONB upsert | Most production apps |
 | **Redis** | Hash increment | High-throughput counters |
 | **MongoDB** | Document upsert | Document-oriented stacks |

data/lib/trifle/stats/configuration.rb

@@ -42,6 +42,7 @@ module Trifle
 
       def storage
         return driver unless buffer_enabled
+        return driver if driver.respond_to?(:bypass_buffer?) && driver.bypass_buffer?
 
         @storage ||= Trifle::Stats::Buffer.new(
           driver: driver,

data/lib/trifle/stats/driver/api.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'net/http'
+require 'stringio'
+require 'time'
+require 'uri'
+require 'zlib'
+require_relative '../version'
+
+module Trifle
+  module Stats
+    module Driver
+      class Api
+        ENDPOINT = URI('https://app.trifle.io/api/v1/metrics')
+        TIMEOUT = 10
+        ERROR_BODY_LIMIT = 1024
+
+        class Error < Trifle::Stats::Error
+          attr_reader :status, :response_body, :retry_after, :delivery_unknown
+
+          def initialize(message, status: nil, response_body: nil, retry_after: nil, delivery_unknown: false)
+            super(message)
+            @status = status
+            @response_body = response_body
+            @retry_after = retry_after
+            @delivery_unknown = delivery_unknown
+          end
+        end
+
+        class NetHttpTransport
+          def call(uri:, request:, timeout:)
+            Net::HTTP.start(
+              uri.hostname,
+              uri.port,
+              use_ssl: uri.scheme == 'https',
+              open_timeout: timeout,
+              read_timeout: timeout
+            ) { |http| http.request(request) }
+          end
+        end
+
+        attr_reader :token, :project_id
+
+        def initialize(token:, project_id:, transport: NetHttpTransport.new)
+          raise ArgumentError, 'token must not be empty' if token.to_s.strip.empty?
+          raise ArgumentError, 'project_id must not be empty' if project_id.to_s.strip.empty?
+
+          @token = token.to_s
+          @project_id = project_id.to_s
+          @transport = transport
+        end
+
+        def description
+          self.class.name
+        end
+
+        def bypass_buffer?
+          true
+        end
+
+        def direct_write(operation:, key:, at:, values:, untracked: false)
+          body = gzip(JSON.generate(
+                        operation: operation.to_s,
+                        key: key,
+                        at: at.to_time.iso8601(6),
+                        values: values,
+                        untracked: untracked
+                      ))
+          request = Net::HTTP::Post.new(ENDPOINT)
+          request['Authorization'] = "Bearer #{token}"
+          request['X-Trifle-Source-Id'] = project_id
+          request['Content-Type'] = 'application/json'
+          request['Accept'] = 'application/json'
+          request['Content-Encoding'] = 'gzip'
+          request['User-Agent'] = "trifle-stats-ruby/#{Trifle::Stats::VERSION}"
+          request.body = body
+
+          response = @transport.call(uri: ENDPOINT, request: request, timeout: TIMEOUT)
+          return true if response.code.to_i.between?(200, 299)
+
+          response_body = response.body.to_s.byteslice(0, ERROR_BODY_LIMIT)
+          raise Error.new(
+            "Trifle API returned HTTP #{response.code}",
+            status: response.code.to_i,
+            response_body: response_body,
+            retry_after: response['Retry-After']
+          )
+        rescue Error
+          raise
+        rescue StandardError => e
+          raise Error.new("Trifle API request failed: #{e.message}", delivery_unknown: true), cause: e
+        end
+
+        def inc(*)
+          unsupported!(:track)
+        end
+
+        def set(*)
+          unsupported!(:assert)
+        end
+
+        def get(*)
+          unsupported!(:values)
+        end
+
+        def ping(*)
+          unsupported!(:beam)
+        end
+
+        def scan(*)
+          unsupported!(:scan)
+        end
+
+        private
+
+        def gzip(value)
+          output = StringIO.new
+          Zlib::GzipWriter.wrap(output) { |writer| writer.write(value) }
+          output.string
+        end
+
+        def unsupported!(operation)
+          message = "#{operation} must be called through Trifle::Stats; " \
+                    'API driver does not support direct storage operations'
+          raise Error, message
+        end
+      end
+    end
+  end
+end

data/lib/trifle/stats/operations/timeseries/increment.rb

@@ -26,6 +26,16 @@ module Trifle
           end
 
           def perform
+            if config.driver.respond_to?(:direct_write)
+              return config.driver.direct_write(
+                operation: :track,
+                key: key,
+                at: @at,
+                values: values,
+                untracked: @untracked
+              )
+            end
+
             payload = {
               keys: config.granularities.map { |granularity| key_for(granularity: granularity) },
               values: values

data/lib/trifle/stats/operations/timeseries/set.rb

@@ -26,6 +26,16 @@ module Trifle
           end
 
           def perform
+            if config.driver.respond_to?(:direct_write)
+              return config.driver.direct_write(
+                operation: :assert,
+                key: key,
+                at: @at,
+                values: values,
+                untracked: @untracked
+              )
+            end
+
             payload = {
               keys: config.granularities.map { |granularity| key_for(granularity: granularity) },
               values: values

data/lib/trifle/stats/version.rb

@@ -2,6 +2,6 @@
 
 module Trifle
   module Stats
-    VERSION = '2.5.0'
+    VERSION = '2.6.0'
   end
 end

data/lib/trifle/stats.rb

@@ -99,3 +99,5 @@ module Trifle
     end
   end
 end
+
+require 'trifle/stats/driver/api'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trifle-stats
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Jozef Vaclavik
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-14 00:00:00.000000000 Z
+date: 2026-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -225,6 +225,7 @@ files:
 - lib/trifle/stats/designator/geometric.rb
 - lib/trifle/stats/designator/linear.rb
 - lib/trifle/stats/driver/README.md
+- lib/trifle/stats/driver/api.rb
 - lib/trifle/stats/driver/mongo.rb
 - lib/trifle/stats/driver/mysql.rb
 - lib/trifle/stats/driver/postgres.rb