omnitrack-rb 0.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3159ca70c1926bd7576f69daa82b043b7712219c920ad13c956560294b52940c
-  data.tar.gz: 8f86771d6bba1b2c6531b1076c369eb464faa40406d111aacebe0610273f83df
+  metadata.gz: aa0f487b57d4c47c6a3168bb0b2583982926b1361f30d95a4d349f3a3bae9834
+  data.tar.gz: 2c5c0967326204f7e9e83f5e43b80c05ee97b1ea414af87ada2fb785b11d2211
 SHA512:
-  metadata.gz: d49fed2d40c06182c33922feafdf8fb7969480c3468d03b95248594fb16517ce0e6f8cc3171c002bd3d8b83ce9fa097d0f61bb88bdf7156015cfa10ea50d16de
-  data.tar.gz: d95277587d7eab7b07e4cebbad26e593d96ee00dafff1ebcbcc45953d073db1255c6b27585011e61b006131078c93814d6e530e4986660a6d0c7cd692efef4db
+  metadata.gz: a27d997c0372cb36c36c4c84816739c66ddf886b6953985ebb27f940fb6f2babf5f2111e8d36555aae09e90c8a10138478d0ba6fc0eca79c11dbc6476c2234fa
+  data.tar.gz: c1bb1d889f61bfdd656ab0ede5b7d2ccc7b432fcf4b7db335c63789d709736caa8dd3cb1d8fe614ec5c7214e46fe28c8cc85ba306fb0cef69b82c48c9ca9db60

data/AI_GEM_SETUP.md

@@ -4,6 +4,30 @@ Use this document when **adding `omnitrack-rb` to an existing Rails 6+ app** so
 
 ---
 
+## 0. Ruby version (including 2.7.8)
+
+The gem declares **`required_ruby_version >= 2.7.0`** and is written to run on **Ruby 2.7.8** without Ruby 3-only syntax. Your **host app** should use a supported Ruby and lock it so CI and production match.
+
+**Example in the host `Gemfile` (optional but recommended):**
+
+```ruby
+ruby "2.7.8"   # or "3.0.6", "3.2.2", etc. — must be >= 2.7.0
+```
+
+**Check locally:**
+
+```bash
+ruby -v    # should be 2.7.8 or newer
+```
+
+**Rails:** use **Rails 6.x or 7.x** (or newer) with a Ruby version that Rails supports for that release. If the app is stuck on **Ruby 2.7.8**, keep **Rails 6.1.x** (or the last 6.x line you use) unless you have verified a newer stack.
+
+**Bundler:** Bundler 2.x is typical; run `bundle install` with the same Ruby the app uses in production.
+
+Nothing else is required for 2.7.8 specifically — no extra `require` in `application.rb`; the Railtie loads OmniTrack like any other Rails engine/gem.
+
+---
+
 ## 1. Gemfile (required)
 
 In the **host** application `Gemfile`:
@@ -128,6 +152,7 @@ Until `Omnitrack::Jobs::TrackingJob` and ActiveJob are loaded, the gem runs sync
 
 | Symptom | What to do |
 |--------|------------|
+| `ruby` version error from Bundler | Host `Gemfile` `ruby "x.y.z"` must match your runtime; use `ruby -v` and align RVM/rbenv/asdf. |
 | `uninitialized constant Omnitrack` | Run `bundle install`; ensure `config/application.rb` loads Bundler default group; boot with `bin/rails c`. |
 | `ENV[...] is nil` in logs | Adapters with `enabled: true` but missing tokens may log or skip; set `*_ENABLED=false` until credentials exist. |
 | Job errors when `async: true` | Set `config.async = false` until ActiveJob and queue are configured, or add queue adapter. |

data/CHANGELOG.md

@@ -2,18 +2,26 @@
 
 ## [Unreleased]
 
+## [2.0.0] - 2026-04-26
+
 ### Added
 - `AI_GEM_SETUP.md` — step-by-step integration for host apps (Bundler, initializer, ENV, ActiveJob, pitfalls)
 - `.env.example` — variable names matching the install template; install generator copies `env.example` → `.env.example` when missing
 - `USAGE.md` — concrete ERB/Ruby examples for layout, HTML/API controllers, and a service object
+- `lib/omnitrack/compat/hash_compact_backport` — `Hash#compact` on Rubies before 3.1 (e.g. 2.7.x, 3.0)
 
 ### Fixed
+- **Ruby 2.7.8** and **Ruby 3.0** compatibility: no endless `def` or `filter_map` (require Ruby 3+ in core for those); compatible `Enumerable` + `Hash#compact` usage
 - Conventional `lib/omnitrack` gem layout, loadable `require "omnitrack"`
 - `rails generate omnitrack:install` generator at `lib/generators/omnitrack/install/`
 - `Omnitrack::Controller` as an alias of `Omnitrack::Concerns::Controller`
 - Default `adapter_name` for adapters uses `underscore` (snake_case) so config keys (e.g. `google_ads`) match the registry; `Omnitrack.reset!` re-registers first-party adapters in tests
 - `activesupport` as a direct runtime dependency; explicit requires for `ActiveSupport` extensions used at load time
 
+### Upgrade from 0.1.0
+- In the host `Gemfile`, pin `gem "omnitrack-rb", "~> 2.0"` and run `bundle update omnitrack-rb`
+- If you had relied on a mis-registered adapter key (`:googleads` from an old build), use **`google_ads`** in `config.adapters` (and env-driven flags) to match the registry
+
 ## [0.1.0] - 2024-01-15
 
 ### Added

data/README.md

@@ -1,7 +1,7 @@
 # OmniTrack-rb 🎯
 
 [![Gem Version](https://img.shields.io/gem/v/omnitrack-rb)](https://rubygems.org/gems/omnitrack-rb)
-[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%202.7-red)](https://www.ruby-lang.org)
+[![Ruby](https://img.shields.io/badge/ruby-2.7%2B-red)](https://www.ruby-lang.org)
 [![Rails](https://img.shields.io/badge/rails-%3E%3D%206.0-red)](https://rubyonrails.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE.txt)
 
@@ -9,6 +9,8 @@
 
 OmniTrack dispatches events to multiple ad/analytics platforms through a clean adapter pattern — works identically in full-stack and API-only Rails apps, never crashes your main application, and emits structured JSON logs to a dedicated file.
 
+Runtime: **Ruby ≥ 2.7** (including **2.7.8**) and **Rails ≥ 6**. No Ruby 3-only syntax in the gem runtime.
+
 **Practical usage (file placement + method examples):** [USAGE.md](USAGE.md)  
 **Add the gem to any Rails app without boot errors (ENV, jobs, checklists):** [AI_GEM_SETUP.md](AI_GEM_SETUP.md)  
 **ENV variable names (copy into host `.env.example`):** [.env.example](.env.example)

data/lib/omnitrack/compat/hash_compact_backport.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Hash#compact was added in Ruby 3.1. This gem supports Ruby 2.7+ and runs on
+# Ruby 3.0 with no core Hash#compact, so we backport only when missing.
+
+unless {}.respond_to?(:compact)
+  class Hash
+    def compact
+      select { |_, v| !v.nil? }
+    end
+  end
+end

data/lib/omnitrack/context.rb

@@ -54,9 +54,17 @@ module Omnitrack
       self
     end
 
-    def gclid  = click_ids[:gclid]
-    def fbclid = click_ids[:fbclid]
-    def ttclid = click_ids[:ttclid]
+    def gclid
+      click_ids[:gclid]
+    end
+
+    def fbclid
+      click_ids[:fbclid]
+    end
+
+    def ttclid
+      click_ids[:ttclid]
+    end
 
     # Full context as a hash — passed into adapter payloads
     def to_h

data/lib/omnitrack/registry.rb

@@ -38,7 +38,7 @@ module Omnitrack
       # Instantiate all *enabled* adapters based on current configuration.
       # @return [Array<Omnitrack::Adapters::Base>]
       def enabled_adapters
-        MUTEX.synchronize { @adapters.dup }.filter_map do |adapter_name, klass|
+        MUTEX.synchronize { @adapters.dup }.map do |adapter_name, klass|
           cfg = Omnitrack.config.adapter_config(adapter_name)
           next unless cfg.fetch(:enabled, false)
 
@@ -47,7 +47,7 @@ module Omnitrack
           Omnitrack.logger.error("registry.init_error",
                                  adapter: adapter_name, message: e.message)
           nil
-        end
+        end.compact
       end
 
       # Clear all registrations (useful in tests)

data/lib/omnitrack/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Omnitrack
-  VERSION = "0.1.0"
+  VERSION = "2.0.0"
 end

data/lib/omnitrack.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "omnitrack/compat/hash_compact_backport"
 require "active_support/concern"
 require "active_support/core_ext/object/blank"
 require "active_support/core_ext/string/inflections"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omnitrack-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Your Name
@@ -164,6 +164,7 @@ files:
 - lib/omnitrack/adapters/meta.rb
 - lib/omnitrack/adapters/snapchat.rb
 - lib/omnitrack/adapters/tiktok.rb
+- lib/omnitrack/compat/hash_compact_backport.rb
 - lib/omnitrack/concerns/controller.rb
 - lib/omnitrack/configuration.rb
 - lib/omnitrack/context.rb