smart_cache_tenant 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a93f98aff4e2b9f648df7da645a638e272db90a42b4953fbf5496b9046f5f56a
-  data.tar.gz: 05bf862690128e59b1f154f272d1761ce9da8cdb156796b5dc782c2932081490
+  metadata.gz: 20af159441d25b27dbcf6b128dc18a820c7271a44d7ddfd11743b600911aa907
+  data.tar.gz: 34e7d995c651f2034bfb0f583beff24479414c9e7e737faf2734880c900ce863
 SHA512:
-  metadata.gz: 51849b0dcec7fd037cb92e0900159cd23da5dce5732b2f5bb562b367878bc8b0c7608e3b5038c9b0767f5b7dafa08d5c80651d886165ebd1b677a5521589731b
-  data.tar.gz: cd03d5da66ff96284e1c83effe0c8897acd2443dbb5839cf421d02b439207bca2feefde5f70af23b8314910d313cfd89b6f2304f3e0acf2715017f8e391af0af
+  metadata.gz: 9c1568821feb22552554776c1c412d866bb59367af4cb628ddcede07c2e465ee22ce8db47dde0033b0674df5fe81c5bc1a1e257e9506777a0b90ed978529c69b
+  data.tar.gz: b2c9215c5bcf704814eabdea230eebd656eeaa62c480641624d7ba10c41651ebc953426e73c109a3f6de1c3db1591f3d45029258fbc0b9b747e174df2e1ebe3a

data/.rspec

@@ -0,0 +1,2 @@
+--require spec_helper
+--format documentation

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-05-02
+
+- Fixed tenant version invalidation path in `VersionStore.bump!` when `tenant_column` is configured and `tenant_id` is blank.
+- Added wildcard invalidation behavior to clear tenant-scoped version keys on global bulk invalidation scenarios.
+- Added Rails 7 runtime dependency declaration in the gemspec.
+- Added a development bootstrap for `bin/console` with a minimal Rails + ActiveRecord environment.
+- Added a complete RSpec suite covering cached reads, version store behavior, `after_commit` invalidation, and bulk write invalidation (`insert_all`, `upsert_all`, `update_all`).
+
 ## [0.2.0] - 2026-05-01
 
 - Added all features and improvements for the first major release.

data/README.md

@@ -257,7 +257,11 @@ This is useful during rollout to confirm which queries are being served from cac
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies.
+
+Run `bin/console` to start an interactive prompt with a minimal Rails + ActiveRecord environment (SQLite in-memory and Rails cache configured). A sample `ConsoleProject` model is available to validate cache behavior quickly.
+
+Run `bundle exec rspec` to execute the automated tests.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 

data/lib/smart_cache_tenant/cacheable_persistence.rb

@@ -18,15 +18,15 @@ module SmartCacheTenant
 
     def bump_smart_cache_for_class_bulk_write!(attributes)
       return unless try(:smart_cache_enabled?)
-      return if attributes.blank?
+      return if attributes.respond_to?(:empty?) && attributes.empty?
 
       tenant_column = SmartCacheTenant.config.tenant_column
-      tenant_ids = Array(attributes).filter_map do |row|
+      tenant_ids = Array(attributes).map do |row|
         next unless row.respond_to?(:[])
         next if tenant_column.blank?
 
         row[tenant_column] || row[tenant_column.to_sym] || row[tenant_column.to_s]
-      end.compact.uniq
+      end.compact_blank.uniq
 
       if tenant_ids.empty?
         SmartCacheTenant::VersionStore.bump!(self)

data/lib/smart_cache_tenant/cacheable_relation.rb

@@ -55,21 +55,21 @@ module SmartCacheTenant
       end
     end
 
-    def update_all(updates)
+    def insert_all(attributes, returning: nil, unique_by: nil, record_timestamps: nil)
       result = super
-      bump_smart_cache_for_bulk_write!(affected_rows: result)
+      bump_smart_cache_for_class_bulk_write!(attributes: attributes)
       result
     end
 
-    def insert_all(attributes, returning: nil, unique_by: nil, record_timestamps: nil)
+    def upsert_all(attributes, on_duplicate: :update, update_only: nil, returning: nil, unique_by: nil, record_timestamps: nil)
       result = super
-      bump_smart_cache_for_bulk_write!(tenant_ids: tenant_ids_from_bulk_attributes(attributes)) if attributes.present?
+      bump_smart_cache_for_class_bulk_write!(attributes: attributes)
       result
     end
 
-    def upsert_all(attributes, on_duplicate: :update, update_only: nil, returning: nil, unique_by: nil, record_timestamps: nil)
+    def update_all(updates)
       result = super
-      bump_smart_cache_for_bulk_write!(tenant_ids: tenant_ids_from_bulk_attributes(attributes)) if attributes.present?
+      bump_smart_cache_for_class_bulk_write!(affected_rows: result)
       result
     end
 
@@ -160,24 +160,26 @@ module SmartCacheTenant
       nil
     end
 
-    def tenant_ids_from_bulk_attributes(attributes)
+    def resolve_tenant_ids_from_bulk_attributes(attributes)
+      return if attributes.respond_to?(:empty?) && attributes.empty?
+      
       tenant_column = SmartCacheTenant.config.tenant_column
-      return [] if tenant_column.blank?
-
-      Array(attributes).filter_map do |row|
+      Array(attributes).map do |row|
         next unless row.respond_to?(:[])
+        next if tenant_column.blank?
 
         row[tenant_column] || row[tenant_column.to_sym] || row[tenant_column.to_s]
-      end.uniq
+      end.compact_blank.uniq
     end
 
-    def bump_smart_cache_for_bulk_write!(tenant_ids: nil, affected_rows: nil)
+    def bump_smart_cache_for_class_bulk_write!(attributes: nil, affected_rows: nil)
       return unless klass.try(:smart_cache_enabled?)
+      return if attributes.respond_to?(:empty?) && attributes.empty?
       return if affected_rows.respond_to?(:zero?) && affected_rows.zero?
 
-      resolved_tenant_ids = Array(tenant_ids).compact
+      resolved_tenant_ids = Array(resolve_tenant_ids_from_bulk_attributes(attributes)) 
       resolved_tenant_ids << resolve_tenant_id
-      resolved_tenant_ids = resolved_tenant_ids.compact.uniq
+      resolved_tenant_ids = resolved_tenant_ids.compact_blank.uniq
 
       if resolved_tenant_ids.empty?
         SmartCacheTenant::VersionStore.bump!(klass)

data/lib/smart_cache_tenant/model_callbacks.rb

@@ -27,7 +27,11 @@ module SmartCacheTenant
     end
 
     def smart_cache_bump!
-      SmartCacheTenant::VersionStore.bump!(self.class, try(SmartCacheTenant.config.tenant_column))
+      self.class.smart_cache_bump!(try(SmartCacheTenant.config.tenant_column))
+    end
+
+    def smart_cached_version
+      self.class.smart_cached_version(try(SmartCacheTenant.config.tenant_column))
     end
 
     private

data/lib/smart_cache_tenant/railtie.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'rails/railtie'
+
 module SmartCacheTenant
   class Railtie < Rails::Railtie
     initializer 'smart_cache.initialize' do

data/lib/smart_cache_tenant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SmartCacheTenant
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/smart_cache_tenant/version_store.rb

@@ -9,10 +9,14 @@ module SmartCacheTenant
 
     def self.bump!(model_klass, tenant_id = nil)
       key = build_key(model_klass, tenant_id)
-      new_version = generate_version
-      Rails.cache.write(key, new_version, expires_in: SmartCacheTenant.config.ttl)
 
-      new_version
+      if SmartCacheTenant.config.tenant_column.present? && tenant_id.blank?
+        Rails.cache.delete_matched("#{key}:*")
+      else
+        new_version = generate_version
+        Rails.cache.write(key, new_version, expires_in: SmartCacheTenant.config.ttl)
+        new_version
+      end
     end
 
     def self.build_key(model_klass, tenant_id = nil)

metadata

@@ -1,15 +1,63 @@
 --- !ruby/object:Gem::Specification
 name: smart_cache_tenant
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Henrique A. Shiraishi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-01 00:00:00.000000000 Z
-dependencies: []
+date: 2026-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
 description: SmartCacheTenant adds tenant-aware query caching on top of ActiveRecord
   by storing cached read results in Rails.cache and invalidating them through lightweight
   version keys.
@@ -19,6 +67,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rspec"
 - ".ruby-version"
 - CHANGELOG.md
 - LICENSE.txt