llm_cost_tracker 0.6.0 → 0.7.0

data/docs/upgrading.md

@@ -1,47 +0,0 @@
-# Upgrading
-
-LLM Cost Tracker is still moving quickly, so upgrades should be explicit:
-inspect the changelog, run doctor, and apply only the generators your schema is
-missing.
-
-The version-by-version upgrade guide is moving here from the README.
-
-## Canonical Sources
-
-Until this page is expanded, use:
-
-- [Changelog](../CHANGELOG.md)
-- [Quickstart](../README.md#quickstart)
-- [Operations](operations.md)
-
-## Schema Generators
-
-Existing installs can add newer optional columns through focused generators:
-
-```bash
-bin/rails generate llm_cost_tracker:add_period_totals
-bin/rails generate llm_cost_tracker:add_ingestion
-bin/rails generate llm_cost_tracker:add_streaming
-bin/rails generate llm_cost_tracker:add_provider_response_id
-bin/rails generate llm_cost_tracker:add_usage_breakdown
-bin/rails generate llm_cost_tracker:upgrade_tags_to_jsonb
-bin/rails generate llm_cost_tracker:upgrade_cost_precision
-bin/rails generate llm_cost_tracker:add_latency_ms
-bin/rails db:migrate
-bin/rails llm_cost_tracker:doctor
-```
-
-On PostgreSQL, `upgrade_tags_to_jsonb` rewrites `llm_api_calls`. For large
-tables, run it during a maintenance window or replace it with a two-phase
-backfill.
-
-## Upgrade Habit
-
-Run:
-
-```bash
-bin/rails llm_cost_tracker:doctor
-```
-
-Doctor tells you which optional columns and production-hardening pieces are still
-missing.

data/lib/llm_cost_tracker/configuration/storage_backend.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module LlmCostTracker
-  module ConfigurationStorageBackend
-    def storage_backend=(value)
-      ensure_shared_configuration_mutable!
-      @storage_backend = normalize_storage_backend(value)
-    end
-
-    private
-
-    def normalize_storage_backend(value)
-      value = :log if value.nil?
-      value = value.to_sym
-      return value if self.class::STORAGE_BACKENDS.include?(value)
-      return value if defined?(Storage::Registry) && Storage::Registry.registered?(value)
-
-      names = if defined?(Storage::Registry)
-                Storage::Registry.names
-              else
-                self.class::STORAGE_BACKENDS
-              end
-      raise Error, "Unknown storage_backend: #{value.inspect}. Use one of: #{names.join(', ')}"
-    end
-  end
-end

data/lib/llm_cost_tracker/engine_compatibility.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module LlmCostTracker
-  module EngineCompatibility
-    REQUIRED_RAILS_VERSION = Gem::Version.new("7.1.0")
-
-    class << self
-      def check_rails_version!(version)
-        return if Gem::Version.new(version) >= REQUIRED_RAILS_VERSION
-
-        raise LlmCostTracker::Error, "LlmCostTracker::Engine requires Rails 7.1+"
-      end
-    end
-  end
-end

data/lib/llm_cost_tracker/storage/custom_backend.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "registry"
-
-module LlmCostTracker
-  module Storage
-    class CustomBackend
-      class << self
-        def save(event)
-          result = LlmCostTracker.configuration.custom_storage&.call(event)
-          result == false ? false : event
-        end
-
-        def verify
-          if LlmCostTracker.configuration.custom_storage.respond_to?(:call)
-            return [
-              VerificationResult.new(
-                :ok,
-                "storage",
-                "custom storage callable configured; external sink was not invoked"
-              )
-            ]
-          end
-
-          [
-            VerificationResult.new(:error, "storage", "custom storage backend requires config.custom_storage")
-          ]
-        end
-      end
-    end
-  end
-end

data/lib/llm_cost_tracker/storage/log_backend.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../logging"
-require_relative "registry"
-
-module LlmCostTracker
-  module Storage
-    class LogBackend
-      class << self
-        def save(event)
-          config = LlmCostTracker.configuration
-          message = "#{event.provider}/#{event.model} " \
-                    "tokens=#{event.total_tokens} " \
-                    "cost=#{cost_label(event)}"
-          message += " latency=#{event.latency_ms}ms" if event.latency_ms
-          message += " stream=#{event.stream}" if event.stream
-          message += " source=#{event.usage_source}" if event.usage_source
-          message += " tags=#{event.tags}" unless event.tags.empty?
-
-          Logging.log(config.log_level, message)
-          event
-        end
-
-        def verify
-          [
-            VerificationResult.new(:ok, "storage", "log backend configured; capture writes to logs only")
-          ]
-        end
-
-        private
-
-        def cost_label(event)
-          event.cost ? "$#{format('%.6f', event.cost.total_cost)}" : "unknown"
-        end
-      end
-    end
-  end
-end

data/lib/llm_cost_tracker/storage/registry.rb

@@ -1,63 +0,0 @@
-# frozen_string_literal: true
-
-require "monitor"
-
-require_relative "../errors"
-
-module LlmCostTracker
-  module Storage
-    VerificationResult = Data.define(:status, :name, :message)
-
-    module Registry
-      MUTEX = Monitor.new
-
-      class << self
-        def register(name, backend)
-          name = normalize_name(name)
-          validate_backend!(backend)
-          MUTEX.synchronize { @backends = backends.merge(name => backend).freeze }
-          backend
-        end
-
-        def fetch(name)
-          key = normalize_name(name)
-          backends.fetch(key) do
-            raise Error, "Unknown storage_backend: #{key.inspect}. Use one of: #{names.join(', ')}"
-          end
-        end
-
-        def registered?(name)
-          backends.key?(normalize_name(name))
-        end
-
-        def names
-          backends.keys
-        end
-
-        private
-
-        def backends
-          @backends || MUTEX.synchronize { @backends ||= {}.freeze }
-        end
-
-        def normalize_name(name)
-          name.to_sym
-        end
-
-        def validate_backend!(backend)
-          return if backend.respond_to?(:save)
-
-          raise ArgumentError, "storage backend must respond to save"
-        end
-      end
-    end
-
-    def self.register(name, backend)
-      Registry.register(name, backend)
-    end
-
-    def self.backends
-      Registry.names
-    end
-  end
-end